Accessibility guidelines: for writing and beyond

Accessibility is an important aspect of any good web project, and docs are no exception. As one advocate puts it, “… if the content design is simple, concise, and clear you are already doing a lot for both a11y and localization.”

And to make this page as accessible as possible: the term a11y is what’s called a numeronym, or shorthand in this case for “accessibility”, where 11 is the number of letters between the a and the y.

See also reducing bias in your writing.

And for general writing style, see style guides.

More resources

Exhaustive resources for web accessibility

Writing for accessibility includes making sure copy can be read by screenreaders, content organization, style and color of text emphasis, and more.

Relevant talks from Write the Docs: