You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Add language identifiers to the code blocks in three reference solutions #268
Without a language, the site cannot highlight the block, and a reader cannot tell from the source whether a block is a command to type, output to expect or a file's contents. Naming it (bash, text, markdown) makes that explicit.
Why this is a good first issue
It is eight small edits in three files, and each one asks a single question: what is in this block?
What to do
Open each file and find the opening fence of each block the check reports: node scripts/check-docs-accessibility.js --report docs/solutions/solution-04-branch-out.md docs/solutions/solution-05-make-your-mark.md docs/solutions/solution-07-merge-conflict.md.
Add a language after the opening backticks: bash for commands, text for output or plain text, markdown for Markdown, diff for a diff. Change nothing inside the block.
Lower the counts for these files in scripts/docs-accessibility-baseline.json (delete the code-fence-language entry when it reaches zero).
Run npm run build:html and commit the Markdown and the regenerated html/ together.
Acceptance criteria
The report command above lists no code-fence-language findings for the three files.
npm run check:accessibility passes.
The same finding appears in about 30 other files; they are listed in #267 and can be picked up the same way, a few files per pull request.
Activity
Fix documentation and site accessibility findings (#264-#268) (#271)