STATUS: In Force
EFFECTIVE DATE: 30 April 2010
SUNSET DATE: NONE
In Section 508 of the U.S. Department of Health and Human Services (HHS) Policies and Standards, there is a requirement that all documentation published on the internet (including web applications, web pages and all attached files) must be accessible to all individuals, including those with disabilities. The process of preparing accessible documentation is most commonly referred to as "508 compliance," and is heretofore referred to in this document as any of the following: "508 compliant," "508 compliance," "compliant," or "compliance."
This SOP describes the process of preparing or remediating a document that is fully accessible according to HHS Section 508 Standard guidelines.
1.1 Preliminary Requirements
- In this SOP, "document" may refer to any of the following:
- A written or printed paper furnishing information or evidence
- Any written item of a factual or informative nature (includes training materials, books, letters, articles or other)
- A computer data file (including electronic versions of written or printed items, web applications or web pages)
- Only documents in final draft version will be remediated for 508 compliance.
- Any working document not yet in its final draft version must undergo peer review and approval prior to being remediated for 508 compliance.
- Documents must be reviewed and remediated for 508 compliance by someone other than the author.
- Documents must be stored in a central source repository for 508 compliance review, remediation and delivery.
- Documents must be versioned.
- Documents must be delivered from the source repository rather than the author or other individual.
- Documents that fail accessibility testing must be edited to comply with 508 Standard guidelines.
- Any document failing accessibility testing will be returned to the author for edits.
- Any time an existing 508 compliant document is edited, it must undergo the 508 compliance remediation process again once the edits have been peer reviewed and approved.
- Documents must be readable and navigable using Assistive Technology.
- Documents must have a clear hierarchical structure based on styles.
- Documents must be created and/or remediated using reliable, industry standard publishing tools (e.g. MS Office, Adobe).
1.2 Common Elements Required by HHS
- Document properties for Title, Author, Subject, Keywords, and Language are properly filled out.
- All Comment and Markup items are deleted and Track Changes is turned off.
- No hidden data is present.
- Color is not the only method used to convey important information.
- There are no flashing/flickering or animated elements.
- All images and/or non-text elements have alternative text descriptions.
- All charts and graphs have either an alternative text description or provide a description in the text immediately below the chart/graph.
- Data tables identify row and column headers.
- Data cells in tables are associated with row and column headers.
- There are no merged cells in tables.
- All tables read from left to right and top to bottom.
- All hyperlinks are active and use the fully-qualified URL (e.g. http://www.hhs.gov/ rather than simply www.hhs.gov).
- Delete or remove tracked changes and previous version information.
1.3 Preparing a 508 Compliant PowerPoint Document
1.3.1 Format and Layout
- All slide text must be viewable in the Outline view.
- All slides must use Master text styles.
- All narrative text on a slide must be in a single text box.
- Slide text may not be flickering, flashing or animated.
- Slide text must be a color that has high visual contrast to the slide background
- Example: black or dark blue text on a white or light gray background
- If text of a different color is used for emphasis, a text explanation of the emphasis must also be included.
- Example: if correct answers are highlighted using red text instead of black, the words "correct answer" must also be included next to the colored text
- Slide text must be a recommended font, such as Arial, Times New Roman, Verdana, Tahoma or Helvetica.
- All hyperlinks must be fully qualified URLs that validate to an active Web destination
- Example: http://www.samhsa.gov/, not www.samhsa.gov
- Tracked changes must be accepted or rejected and turned off.
- All comments and formatting marks must be turned off.
- All slide graphics that convey information (including but not limited to images, diagrams, flowcharts, callouts and non-text elements) must have Alternative Text (alt text, aka alt tag) associated with them.
- All slide graphics should be inserted into slides as individual objects rather than embedded in text boxes.
- Use the Insert function to properly insert images or objects into slides.
- Do not copy images or objects from other documents and paste them into slides.
- Images that are included in the Master Slide (such as backgrounds, logos or other graphics editable only in the Master Slide View) will not be accessible to a screen reader.
- Images that do not convey information and are used for visual interest only should have blank alt tags.
- Multiple images or objects on one slide should be grouped and tagged as one object.
- Use a screen capture application to convert multiple elements on one slide into a single image. Insert the single image into the slide.
- Refer to the NCI Training Team "SnagIt How-To" for instructions in section 1.5 Reference Documentation.
220.127.116.11 Alt Text/Alt Tags
- Text describing a graphic must be in a slide immediately following the graphic or preferably on the same slide if space permits.
- Text must specify what is depicted in the graphic (e.g. process flow chart, screen shot, picture, clip art, table, shapes).
- Example: "This graphic is a screen shot of the Alert List page in the Sentinel Tool."
- Example: "This graphic is a flow chart of how oxygen gets processed and converted into carbon dioxide by a plant."
- Example: "This graphic is a humorous picture of a dog seated at a table as if he's ready to dine with humans."
- Text must describe the specific elements of the graphic—it cannot simply state what the graphic shows.
- Incorrect example: "This graphic shows the components of a Data Element."
- Correct example: "This graphic shows the breakdown of the components of a Data Element. Data Elements are created by adding pieces of metadata together, including a Data Element Concept and a Value Domain. A Data Element Concept is made up of an object class and property. A Data Element Concept is added to a value domain to create the Data Element."
- Text must explain the purpose of the graphic if it is not directly related to material that preceded it or if it. This is especially important when a graphic ties together information from more than one section of materials or provides an outside example for material that has been presented.
- Example: Say you wish to convey the usability of the Sentinel Tool in the course materials and you include a graphic that shows how much time a curator can save using the tool. Although the course materials cover use of the tool, this graphic is an example of use of the tool in a workflow, which is related to but not part of the instructions for use. You would use alt text such as this: "This graphic is a comparison flow chart representing how using the Sentinel Tool to track metadata changes as opposed to manually checking designated metadata can save time."
- Complex images that require extensive explanation and cannot be converted into an accessible format must be accompanied by a separate text document. The document must be identified in the presentation.
- Example: a process flow chart showing complex interdependent processes that cannot be described in two or three sentences requires a text equivalent. A separate text document is created, uploaded to a web page, and is accessible from the PowerPoint presentation as a qualified URL.
- Tables must be created within PowerPoint. Tables created outside of PowerPoint must be inserted as graphics and treated as such.
- All tables must be logically laid out in rows and columns based on the content and should be readable from left to right and top to bottom.
- Row and column headers must begin in the first left-hand column of the table.
- All tables must have clearly identifiable row and column headers.
- Tabular data must be displayed in a table. Text may not be aligned into a tabular format using tabs and spaces.
- Descriptive text must be included to identify the name of the table (if applicable) and describe its contents.
- Example: "In Table 2 Daily Averages, we are showing daily webpage visitor averages that have fluctuated from 1.2 million to 3.8 million over a time span of the last six months."
1.3.4 Document Names and Properties
- 508 compliant documents should be assigned a file name that ends with the author's initials and 508.
- Example: 1010_intro_to_metadata_in_cadsr_lse_508.ppt
- 508 compliant documents must be saved as MS Office 97-2003 with a ".ppt" file extension.
- Documents cannot be saved with ".pptx" file extensions.
- Document file names must not contain spaces or special characters.
- Use an underscore (_) instead of a space or a dash.
- Do not use any characters other than letters, numbers or underscores (e.g. *, ^, %, #, ~, /, @, +)
- Document file names must be concise and generally limited to between 20 and 30 characters. File contents should be clear within the context the file name is presented.
- Document Properties, including but not limited to Subject, Author, Title, Keywords, and Language, must be properly filled out.
- Document Author must be indicated as organization name rather than individual name (e.g. "NCI Training Team," not "Sam Jones")
1.4 Submitting and Delivering a 508 Compliant Document
1.4.1 Uploading to Source Document Repository
- GForge is currently being used as the source document repository for all published 508 compliant documentation.
- Please refer to section 1.5 Reference Documentation of this document for instructions on how to use GForge.
- Compliant documentation must be placed in the appropriate Project and Folder (to be determined by the workspace or team) in GForge for review by the appropriate individual(s).
- It is the responsibility of the document owner to comply with 508 guidelines. However, it is highly recommended that another team member or individual review posted documentation to ensure compliance.
- Any documentation found to be non-compliant should be removed from GForge, edited, and resubmitted.
1.4.2 Delivering Documents from Source Repository
18.104.22.168 For Training Documentation in the NCI CBIIT Learning Management System (LMS)
- An email must be sent to the appropriate LMS administrator requesting that a link to the source document in GForge be published. The request email should contain the following information:
- Requester's name and contact information
- Name or title of the document
- Type of document (i.e. Course Materials, Quiz, Exercise, other)
- Link location in GForge
- Specific location in LMS where document should be placed (i.e. course number)
- Requester is responsible for confirming receipt and publication of compliant document in correct location with correct link and file name.
22.214.171.124 For Documentation Distributed or Published on Wiki or Other
- A direct link to the compliant source document in GForge should be placed on a wiki page or included in an email or other distribution method.
- When a direct link to the source document in GForge is not practical or feasible, a copy of the compliant document itself must be downloaded from GForge and attached or published.
- NOTE: It is the sole responsibility of the distributor to redistribute updated copies of the source document as it is modified for later versions.
1.5 Reference Documentation
This section include links to all reference documentation, including style guides, online tools (including repository, etc), application user guides on how to format images, create tables, etc. (ppt, word, pdf, excel, snagit, other), and other reference documentation not appropriate for inclusion in its entirety in this document.
- NCI Training Team Style Guide - Curriculum Development Style Guide
- NCI Training Team PowerPoint Style Guide - PowerPoint Style Guide
- NCI Training Team SnagIt How-To - Snag-It How-To
- GForge User Guide
- NCI CBIIT 508 Compliance Wiki - https://wiki.nci.nih.gov/x/1w1y
- Microsoft Excel Help on Wikipedia - http://en.wikipedia.org/wiki/Microsoft_Excel
- Microsoft PowerPoint Help on Wikipedia - http://en.wikipedia.org/wiki/Microsoft_powerpoint
- Microsoft Word Help on Wikipedia - http://en.wikipedia.org/wiki/Microsoft_word
- Adobe Acrobat Help Online - http://www.adobe.com/support/acrobat/