This Wiki page is edited by participants of the Cognitive and Learning Disabilities Accessibility Task Force. It does not necessarily represent consensus and it may have incorrect information or information that is not supported by other Task Force participants, WAI, or W3C. It may also have some very useful information.
Coga terms langauge guide
Contents
COGA Language Guide
Vocabulary
If there are editorial terms that conflict with the intro in WCAG that might cause issues: https://www.w3.org/TR/WCAG21/#background-on-wcag-2
- How should we use impairment or disability?
- What is the best term: bad, poor, or another term? Example: poor memory Resolution: impaired memory
simply: [ https://med.emory.edu/departments/pediatrics/divisions/neonatology/dpc/impairment-mx.html emore] Impairment - any loss or abnormality of psychological, physiological or anatomical structure or function.
Disability - any restriction or lack (resulting from an impairment) of ability to perform an activity in the manner or within the range considered normal for a human being.
from the [the who ]: Disabilities is an umbrella term, covering impairments, activity limitations, and participation restrictions. An impairment is a problem in body function or structure; an activity limitation is a difficulty encountered by an individual in executing a task or action; while a participation restriction is a problem experienced by an individual in involvement in life situations.
Use “Cognitive and learning disabilities” generally instead of "cognitive impairment"
Use "Hand-eye coordination" instead of "Eye-hand coordination"
Use website and webage
Language Guide
- short sentence, paragraphs etc
- active voicing
- simple tense
- lists
- clear common words
- avoid double negatives
- know your audience and use words they know
- consistence voice - tone
- Clear, short, step-by-step instructions
- Explanations of icons, numbers, and acronyms
- clear - do people know what to do. do people know why to do it. do people know what successed and fails
- audence is a wide range of web content creaters, from goole to a teacher making a website for the school.
Clear and Simple Writing
Reference Clear and Simple Writing
DRAFT Grammar and Punctuation
- Use the oxford comma before “and”
- Use American English
- Organize
- Recognize
- For high level statements use plural "Users"
- For examples use "A user" and "They" instead of he/she or s/he
- Capitalize the first letter in each list item and keep sentence punctuation including the period at the end.
- Use sentence case in headings
