Pa11y fixes to Docusuarus

[JoelMarcey]

Is this a bug report?

Not technically, but would be good to fix.

Have you read the Contributing Guidelines?

Yes

Environment

N/A

Steps to Reproduce

1. npm install -g pa11y
2. pa11y https://docusaurus.io

Expected Behavior

No errors

Actual Behavior

A bunch of errors 😄

https://gist.github.com/JoelMarcey/d08263d2acf1819e07538f0a0c5ded93

Reproducible Demo

N/A

[haraldur12]

I am working on it. How shall I be committing to it though ? Do I have to tackle all the errors first and then send the pull request or just send a pull request every time I have checked something ?

[Happy-Ferret]

@haraldur12

Not my project, obviously. But how about you open a PR, start the title with WIP: and then tackle the errors one commit at a time?

[JoelMarcey]

@haraldur12 Hi. We would be happy for you to work on this. As @Happy-Ferret said, you can send one big PR, with multiple commits. Or, maybe preferably, just send multiple PRs -- I tend to like smaller PRs since they are easier to deal with, review, and revert if necessary.

I am going to consider this issue claimed by you. If you do not want to do this any longer, let me know. Thanks.

[yangshun]

@haraldur12 Are you still working on this issue?

[amyrlam]

So, I started fixing some a couple of the Error: Img element missing an alt attribute. Use the alt attribute to specify a short text alternative ones in WIP PR #528.

Then I was wondering if it would be good to add https://github.com/evcohen/eslint-plugin-jsx-a11y to keep it a11y compliant long term.

There are definitely a lot of things to fix if you want to work on it together @haraldur12!

[yangshun]

@haraldur12 , @amyrlam will be working on fixing the rest of the a11y fixes. If you like to work on some of them, please comment here or we will assume that you are ok with us taking over.

[JoelMarcey]

I think at this point, we can have @amyrlam own this issue. If @haraldur12 comments asking to work together, we can see if there is a reasonable way to split up the work.