alvarlagerlof / neurodiversity

📖 Website educating the public about neurodiversity

Hello folks!

My name is Alvar Lagerlöf and I'm a he/him from Stockholm, Sweden. I enjoy making software and designing things. You can find more from me on my Twitter, LinkedIn or my website.

Thank you to the folks who sponsor my work on GitHub!

neurodiversity's Issues

Should show symptoms

It would be good to show common symptoms that can occur when suffering

Figure out a release/editorial process

Currently, the website gets updated publicly whenever there is a push to main. This is not ideal and risky.

For content, it might include these steps

1. Someone fact checks it
2. Someone proofreads it
3. The ready text could be approved by someone/multiple someones
4. Merged to master

New code is submitted as a pull request

1. Tests are ran
2. The code is reviewed
3. The ready code could be approved by someone/multiple someones
4. We may also use branch protection rules to enforce parts of this process.

Localization?

In the long-term, we might want to translate pages to different languages and show the right one based on device language. I can do translations to Swedish. But more languages would be better.

Card links are not accessible

So I've recently read that if a link does not immediately have a text tag inside of it it's not going to sound right in screen readers.

Currently, the links on the start page pointing to subpages using LinkGrid.Item contain a h3 and a p.

The a should probably be inside the h3 according to this. This presents an issue.

We want the whole card to be clickable, but we want the link around the title. I've read an article saying that the correct way ro approach this to capture clicks on the card, and then trigger a click on the link. Then you solve both issues.

Optimize SEO

Figure out what is most important in terms of search ranking, and what shows up when linking, and implement that.

Another site I manage is at 21% CTR so I think we can do better

The og:images are not working everywhere

Prefix with site domain?

Proxy Plausible through Vercel serverless functions

Plausible is privacy-preserving, so I does not need to be blocked by browsers.

https://plausible.io/docs/proxy/guides/nextjs

Should have an ADHD page

Add an ADHD page with a similar structure to the current OCD page

Next.js 11

Remove the word illness

Replace with disability/disorder

Cover a bare-minium set of conditions

Before launch, we should cover some of the most common conditions. I propose we cover at least ADHD, but maybe Bipolar too?

Action Required: Fix Renovate Configuration

There is an error with this repository's Renovate configuration that needs to be fixed. As a precaution, Renovate will stop PRs until it is resolved.

Location: .github/renovate.json
Error type: Invalid JSON (parsing failed)
Message: Syntax error: expecting String near } ] }

Awareness month/day calendar

TBD

Double title appended on some pages

Says "Neurodiversity Wiki - Neurodiversity Wiki"

Make "Find out how" button responsive

Find out how button (in DID and OCD page) isn't responsive

Awareness month/day calendar

Discussed in https://github.com/alvarlagerlof/neurodiversity/discussions/293

^{Originally posted by alvarlagerlof October 2, 2021}
TBD

Make icon in nav clickable

Links to social media and GitHub in footer

Sharing links to a playlist of pages

Let's say you've got a friend/relative who is unaware of your conditions. Instead of sending the multiple pages in a row, what if you could send then a link with all of the right pages included? What if you could also add a comment for each page?

Finalize about text on start page

The text in "Why?" is perhaps the most important in the whole project. We should make sure that it reads as easily as possible and clearly communicates our goals. Maybe a bit of backstory including that the project started as a page just about OCD too?

Allow sending anonymous feedback

Perhaps there should be a way to send feedback for each page. It is important that we ensure that as many people as possible feel represented by out content. We could start with a simple Google form.

In addition, we may be able to highlight personal experiences that people share (not through the feedback above). Like testimonials.

Branch naming guidelines

So far, I've just added branches with pretty much any name. But I think we should prefix them. Maybe something like this:

• content/draft-{page}: For new pages
• content/{page}-{change}: For content changes (spelling, fact checking, more content/sections)
• feature/{change}: For new features/improvements
• fix/{change}: For fixes

Feedback wanted

Treatment and diagnosis

Could be a popup or sub page linked at the bottom of each page.

Track redirects from the old domains

We need to track traffic from the old domains to be able to determine when they can safely be removed

Dark mode support

Suggested on Polywork

README link to neurodiversity.wiki

Hello! I love the idea for this project and would love to contribute!

I noticed that the link to neurodiversity.wiki in the README.md file was linking to https://github.com/jtorreggiani/neurodiversity/blob/main/neurodiversity.wiki. I updated the markdown to fix url's formatting.

I opened a pull request with the fix #100. Excited to contribute!

Local support groups

We might have some sort of section at the bottom of each page where the visitor inputs their city and the website shows a list of supports group in that area

Code of conduct

Preview deploys break og:image for new pages

It is looking for social image on the production url instead of the preview url

Yarn 3

Blocked by pmndrs/react-spring#1731

Tell Google about the new domain

The old domain redirects with 301, so this should be easy

readme typos

There are a couple typos in the readme.
"It's also common to only focus on one conditon, even though knowledge about even though knowledge about most of them is lacking."

I'm something of a proofreader/copy editor and aspiring dev, but I tend to not offer fixes because I don't want to be perceived as "nit-picky." However, with a project such as this, where I have a personally vested interest (bipolar 1, schizoaffective, treatment resistant depression, social anxiety dis, etc) in its success and presentation in the best possible light, I don't think I'm being ocd or nit-picky; just trying to help in whatever way I feel I can. Code contributions can come later, if ever required, but what I can do immediately is scour the copy as a proofreader, and begin making the edits myself as opposed to pointing things out but not being proactive in rectifying what I find. If that would be considered useful, great. If not, no worries. Thanks for the project and all your efforts Alvar. =)

Gene

Sharing summary image

For IG stories, Twitter etc.

Launch checklist 🚀

Sometime soon, we should do a proper launch to spread awareness. Before that we need to discuss what we need to do before

• #124
• #125
• #123
• #151

Completed

• #140
• #126
• #144
• #143