Skip to content

This is an early unpublished editor's draft; content is incomplete and subject to change.

Clear language review

assertion

Normative Text

[Title, role, or organization] asserts that:

  • Our organization has a process and policy to review text content for clear language before publication. The process includes confirming:
    • All of the core requirements in the ‘Clear Language’ guideline are met.
    • Verb tense is chosen for ease of understanding.
    • Content uses short paragraphs.
    • Paragraphs that convey information begin with a sentence stating the main point or purpose (often called a topic sentence).
    • If a style guide is used by content authors, it must provide guidance on these aspects of clear language.
    • If author training is provided, it must provide guidance on these aspects of clear language.

Information that needs to be included publicly:

  • Title, role, or organization making the assertion (if different from the conformance claim).
  • Date of when the policy was implemented.
  • Date of assertion (if different from the date of the conformance claim).

Recommended internal documentation (Informative):

  • Copy of the policy implementing the clear language review.
  • Date author training was provided (if any).
  • Number or proportion of authors who completed the training.
  • Copy of the style guide (if any) where clear language review has been defined.

Tests

This content needs to be written.

Key Terms

accessibility support set

group of user agents and assistive technologies you test with

The AGWG is considering defining a default set of user agents and assistive technologies that they use when validating guidelines.

Accessibility support sets may vary based on language, region, or situation.

If you are not using the default accessibility set, the conformance report should indicate what set is being used.

accessibility supported

available and working in the user agents and assistive technology in the accessibility support set

The working group intended to include a default accessibility support set. See Default accessibility support set #277.

clear language

writing in a simple, direct way

Clear language avoids unnecessary complexity and helps make content accessible to everyone, including people with cognitive disabilities, limited reading skills, and limited language proficiency.

content author

person or persons responsible for the content presented, including word choice, formatting, images, video, audio, and other elements

human language

language that is spoken, written, or signed (through visual or tactile means) to communicate with humans

See also sign language.

programmatically determinable

meaning of the content and all its important attributes can be determined by software functionality that is accessibility supported

sign language

a language using combinations of movements of the hands and arms, facial expressions, or body positions to convey meaning

text

sequence of characters that can be programmatically determined, where the sequence is expressing something in human language

text content

text and formatting that, together with the semantic or hierarchical structure provided by markup, communicate the content and meaning