Screensteps articles can be helpful, but they can only be helpful to everyone if they are created to be accessible. The following is a guide to following accessibility practices when creating a Screensteps article.
Selecting the Heading Style
Heading helps the user understand the page and how it is organized. To find out how to create the correct heading structure, you can go to the article How to Use Heading Structures Correctly and Efficiently.
Watch this quick video on How to Create a New Heading.
Select the heading from the outline view. Drag it to the appropriate heading level you need it to be.
When you complete the dragging of the heading level, it should change from "H2" and the correct heading hierarchy level (ex., H3, H4, etc..).
Adding Alternative Text (Alt. Text)
Describe all visual objects with an Alternative Text (Alt Text).
- Explain “why” the image relates to the content. The Alt Text is read aloud by screen reading software. Review the following article to learn more about How to create Alternative Text.
- Select the image.
- A column for the alt. text will appear on the left hand side of your article.
Checking the Color Contrast
Here are two articles you can reference How to Check Color Contrast with Colour Contrast Analyser (CCA) and How to Check Color Contrast with A11Y.
Using Text Style
When using the text style guides use the default font and color style. Keeping the default settings will keep the color contrast compliant with WCAG standards.
Adding Destination Links
Give hyperlinks meaningful display names.
- Avoid using the actual URL or “click here.
- Review the following article to learn more about How to Create Accessible Descriptive Links
In the Styles gallery, a visual menu is located on the Home tab.
To apply a style, select the text you want to format, and then click the style you want in the Styles gallery. To learn more about Style formatting, visit the Microsoft Support Website:
- Apply a style to text in Word
- Modify a style by updating it to match the formatting in your document
- Modify a style manually in the Modify Style dialog box
Select your paragraph content block to create your destination (meaningful link and description link).
- Type your paragraph.
- Type the destination words that you want to be linked out.
- Highlight the words you typed as the destination, for example, "installing WAVE and using WAVE."
- Select the link icon in the home ribbon.
- Then select "External Link" from the drop-down.
- Paste the link into the text field.
- If you select "Open link in a new window," you must include a written working in the article, warning the user that they will be taken to a new window.
- WCAG standards recommend leaving "Open link in a new window" unselected.
Check Spelling and Grammar
Accessibility best practice recommendation to create a draft in Microsoft Word. You can edit the draft and review the content using the built-in Editor tool, or if you have a Grammarly account, you can copy and paste your draft into Grammarly to check spelling and grammar.
Test for Accessibility Using Web Accessibility Evolution Tool (WAVE)
After you post the article in ScreenSteps, run WAVE to check for accessibility barriers.
The website to learn about WAVE and install is installing WAVE and using WAVE. You can find a video for using WAVE (00:11:20).
Below are Some Best Practices for Creating Accessible Articles
- Keep titles unique and simple
- Use different naming conventions for manuals, chapters, and articles.
- Many users may have difficulty distinguishing between the manual title, chapter title, and article title if they all have the same title.
Below are examples of barriers that may impact the user experience:
This example shows you how the user's experience is impacted when the chapter's title is the same as the article's title:
- Chapter title: "How to enable and create Break Out Rooms in Ring Central Meeting."
- Article title: "How to enable and create Break Out Rooms in Ring Central Meeting."
- Here is an example of an accessible chapter titled "Break Out Rooms in Ring Central."
- Here is an example of an accessible article titled "How to enable and create Break out Rooms in Ring Central Meeting."
Another example that creates a user experience barrier is creating similar titles such as:
- Chapter's title: "How to install the RingCentral Meetings Mobile app on iOS."
- Article title: "How to download and install RingCentral Meetings from the App Store (Apple Devices)."
- Here is an example of an accessible chapter titled "Using Ring Central on Mobile Device."
- Here is an example of an accessible article titled "How to Download and Install Ring Central Meeting From the App Store (Apple Devices)."
Use Inclusive and First Person Language
When creating your job aids, use more inclusive language, for example, “select,” “hit,” "press," or “choose" instead of using the word "click." When we use the word "click," we assume everyone uses a mouse.
Steps to Confirm Videos are Accessible
- Add the time stamp in the format (HH:MM:SS)
- Confirm that closed captions are turned on, and the closed captions are accurate. You can follow this video to show you how to create accessible videos, add captions to your Screen-Cast-O-Matic video, add captions to your Screen-Cast-O-Matic video and change them.
Adding Tags (Relevant Keywords) to Screen Steps Article
It is essential to add tags (relevant keywords) to the article. Tags (relevant keywords) are indivisible labels that add critical information about the article's content. Inserting tags (relevant keywords) will help users discover the article if they need to know precisely what they are looking for.
- These tags help find the articles in the database.
- Go to the Screen Steps online
- Go to the article where you want to add tags (relevant keywords). You can find it under "properties."
- Type in tags (relevant keywords) about your newly created article.
- Use the enter button after typing in one of the tags (relevant keywords). You can use alternative spellings and abbreviations as well.
Please add as many different words to include in your article tags (relevant keywords). Adding searchable keywords will be beneficial to all users.
Additional Resources
- Getting Started with Screensteps: Checklist
- Take this mini-course on how to write great FAQ articles
- Take this mini-course on the basics of using the desktop editor
- Take this mini-course on organizing your knowledge base
- Creating an Accessible Article
- The Nature of HTML
- Data Tables
- Links
- Lists & Columns
- Accessibility Checker
- Principles into Practice
- Designing for Screen Reader Compatibility
- Testing with Screen Readers
- Overview of ScreenSteps
- Organizing Content
- Customize Your Site
- Integrations
- Admin Tasks
- Authoring Content
- PDFs
- Contextual Help
- Creating Courses
- Single Sign-on
- Notifications
- Announcements
- Accessibility
- Example Content
- Best Practices
- FAQs
- Course Materials
- Migrating Existing Content to ScreenSteps
- Salesforce and ScreenSteps
- Implementation Guides