Accessible writing is clear, concise, and consistent. Use the following best practices to ensure your writing is accessible:
Include one idea in each sentence.
Use short paragraphs instead of large chunks of content. Organizing content under headings can make it easier to read.
Keep your procedures concise. Overly long procedures can be hard to follow and they can create problems for people with cognitive impairments.
Consider the needs of your target audience and only include the information they need. For example, in a document for end users, do not include detailed information about administration tasks.
Use standard steps in a procedure. Only add substeps where they are necessary and add value to the procedure.
Be cautious with how you use directional text, such as above, below, left, and right. The steps and instructions you write should not be reliant on directional text. Some users with cognitive impairments cannot easily understand spatial concepts.
Be specific when writing instructions. For example, Click the File menu
is much more useful than Click the menu on the left.
The latter does not specify which menu and it is hard to follow.