liveBook · Manning

Understanding document

As explained in Architecting Accessibility

An understanding document is WCAG supporting documentation that explains the intent, terms, beneficiaries, examples, techniques, and failures of a guideline or success criterion.

An understanding document explains why a WCAG guideline or success criterion matters and who benefits. For an individual success criterion, it can clarify key terms and concepts, then provide examples, techniques, and failures to make the requirement easier to interpret. section 1.5.1

Use it to interpret requirements, not as a test procedure: ACT rules outline technology-specific steps for testing success criteria. Understanding documents are informative supporting material; the success criteria themselves are the requirements used to determine conformance. section 1.5.1

Figure 1.2 This image illustrates the various components in WCAG 2.2. Guidelines are organized under four principles. Each of the 13 guidelines includes normative success criteria: the requirements used to determine conformance at levels A, AA, or AAA. WCAG also provides informative supporting material, including techniques, understanding documents, testing rules, and additional guidance to help explain and apply those requirements.

See where understanding documents fit among WCAG's requirements and supporting materials. section 1.5.1

How Architecting Accessibility covers it

How deep it goes
Explains intent, terms, beneficiaries, examples, techniques, and failures, but leaves testing steps to ACT rules.
Examples
Uses examples alongside techniques and failures to clarify individual success criteria.
What you can do after
Evaluate/understand a success criterion's intent, key concepts, beneficiaries, and related examples.
How it connects
Connects WCAG guidelines and success criteria with techniques, failures, and accessibility conformance testing rules.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Architecting Accessibility. The section links point to the parts of the book it draws on.