Accessibility Checklist for One Stop

Quick Accessibility guidelines 

Headings 

• Use proper headings in the correct order. Check this in the Navigation Pane.

Alt Text 

• Add clear and meaningful alt text to all images.

Color and Contrast 

• Use colors with good contrast, and don’t rely on color alone to share information.

Links 

• Write link text that clearly explains where the link goes.

Detailed Guidelines

Adding Titles

Incorporate Primary Keywords

• The title should contain the primary keyword(s) that the article is about.

• Example: VPN authentication issue on Windows laptop

Use FAQs

• Use the most frequently asked question that you anticipate employees will ask to find this article

• Example: How to connect Bluetooth headphones with my MacBook?

Add specific context

• Use context in the title. Add details like geography, OS, application name, etc.

• Example: Printer setup on MacBook in West office

Create unique titles

• Multiple articles should not have the same title.

Creating the Article Body

Focused, topically aligned

• If an article has multiple topics covered, split it into separate articles (one for each topic).

Keep it Brief

• We recommend that articles should be ~400 words long

Avoid duplication of content

• Ensure that the article titles created and the underlying body of the articles are not similar to or duplicates of content in other articles.

General recommendations

Use simple language

• The title and body should contain language that everyone can understand and read easily.
• Using unnecessary complex words or sentence structure makes the article more choppy to read and harder for the reader to understand. 

Add images right

• Add title and alt text to images

Add contextual URLs

• Add labels to URLs, or add text alongside URLs in the article body.