Accessibility in One Stop
-
Guidelines: Writing Clear Instructions in One Stop Articles
Fast Five Guidelines: Use numbered lists and bullet points. Use complete sentences. Do not use the word, please. Only state the best way to complete the task without alternatives. List as few steps as possible to complete the task. Top Ten Guidelines for How to Make OneStop Instructions Easier to Read: 1. Make sentences a command. Good: Copy the file that contains the table. Bad: You need the password. Go into the keychain. 2. State the purpose of the task before how to do the task. Good: To start a new document, click File > New > Document. Bad: Click File > New > Document to start a new document. 3. Give the reader the information they need for the task ahead of time. Good: The following hardware and software are required. Bad: Run the installation. When asked for the code, go to the text file. 4. Write in the order that the reader needs to follow. Good: In Microsoft Word, click File > New > Document. Bad: Click File > New > Document in Word. 5. Use consistent verb form. Good: Download the print driver. Click More, and then click Download. Bad: It can be downloaded by clicking More and then clicking Download file. 6. Do not use directional language such as above, below, or bottom left-hand corner. Good: Click Menu. Or: In the preceding diagram. Bad: Click the button with three lines. Or: In the picture above. 7. If the user must press Enter after a step, include that instruction as part of the step. Good: Click the search box, type headers, and then press Enter. Bad: 1) Click the search box and type headers. 2) Press Enter. 8. For an optional step, type “Optional:” as the first word without parentheses. Good: Optional: Enter a PIN code. Bad: (Optional) Enter a PIN code. 9. Do not include keyboard shortcuts. Good: Copy the command, and then paste it. Bad: Press Ctrl+C, and then press Ctrl+V. 10. Focus on what the command prompt does without using “run the following command.” Good: In Terminal, deploy iOS installation. Bad: In Terminal, deploy the installer by running the following command. Please contact Debbie Dramstad, Web Accessibility, and Applications Specialist, for more information.
-
Using Built-In headings in One Stop Articles
Guide to Heading Order and Proper Usage Key Points Use Only One Heading 1: The main title of the article should be marked with a Heading 1 Follow Hierarchical Order of Headings: Maintain a logical flow of headings throughout the article. After Heading 1, use Heading 2, followed by Heading 3, and so on. Avoid skipping levels. Stick to Default Heading Font Size: Use the default font size for headings to maintain consistency and ease of readability. Use Black Font Color: Keep the font color for headings and text black, unless a specific color is necessary for clarity or emphasis. Make Headings Descriptive and Relevant: Ensure that each heading clearly reflects the content it introduces. Descriptive headings help readers easily understand the structure of the article. Using the built-in heading function Heading sizes can be found in the top left corner of the page in the toolbar section. It will be labeled "Paragraph Format" After selecting a heading, you can type out a title. Alternatively, you can change an existing title by simply highlighting the title and clicking on the desired heading. Tip: Bolding each heading in the article is a great way to direct attention to content sections, and clarify article structure by content Example of header use and hierarchical structure in a One Stop article This picture is an example of how an article could be structured using built in headings Notice: In this example there is only one Heading 1, and each subheading stays in the correct order at all times. Example continued
-
Adding Alt Text in One Stop
How do I add Alt text to an image in One Stop? Select the image you wish to add Alt text to. Click on the Alternative Text icon in the toolbar. This will open a text input field where you can enter the alternative text for the image. When you are done typing, select update to save the Alt text to that image. Tips for writing alt text Focus on the important details: Start with the most important information first. Be specific and concise: Describe the content and purpose of the image (e.g., “A bar chart showing revenue growth from 2020 to 2023 from fifteen million dollars to eighteen point five million dollars”) Use an Alt text generator tool. Click here to access ASU Creator tool and tutorial.