Develop handbook content outline and scope

[trallard]

Three main personas we have discussed in the past for the handbook scope are:

• Maintainers (of open source projects)
• Contributors to open-source projects
• Content creators (think docs, notebooks, papers, viz)

Based on those personas, we need to define the relevant content required.

Content creators

Preview Give feedback

1. Notebook authoring guide (see [DOC]- Add accessibility documentation to JupyterLab docs (user) jupyter-a11y-mgmt#173 and Add new accessibility-specific documentation jupyter/accessibility#125)
2. Alt-text guide

Maintainers

Preview Give feedback

1. Conducting user research with disabled users
2. Reviewing PRs for a11y Add new accessibility-specific documentation jupyter/accessibility#125 (comment)
3. Accessibility docs best practices Accessibility docs best practices jupyter/accessibility#15
4. How to - evaluate keyboard navigation
5. Quick accessibility audit and reporting for documentation sites

Resources 📖

• Writing documentation with neurodivergent oss contributors in mind
• Let me learn
• Write the Docs accessibility guide
• Best Practices for Image Text Alternatives
• An Alt Decision Tree
• Accessibility Concerns for Content Staff
• Creating accessible documentation
• Open docs guide