Stay organized with collections
Save and categorize content based on your preferences.
When writing about people with disabilities or about accessibility, be mindful
about using unintentionally biased language that may cause harm.
Write thoughtfully about disability
Don't use euphemisms or patronizing terms:
Avoid describing people without disabilities as normal or healthy.
Better: nondisabled person, sighted person, hearing person, person
without disabilities, neurotypical person.
Avoid terms that reflect or project feelings and judgements about a
person's disability, such as victim of, suffering from, wheelchair-bound.
Better: experiencing, living with, uses a wheelchair
Person-first and identity-first language
When writing about accessibility and people with disabilities, be sure to
center the person or community, and avoid terms that remove personhood.
Avoid language like the disabled
Better: people with disabilities
Note: While person-first language is generally preferred (person with a
cognitive impairment, person with low vision), some people prefer identity-first
language; for example, this preference is common in Deaf and neurodivergent
communities (Deaf person, neurodivergent person).
Before writing about a community, take time to educate yourself about how the
community prefers to be identified and described. Some helpful resources include
the following:
Write documentation for all: General guidelines and examples that
illustrate some best practices for writing documentation for everyone.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-17 UTC."],[[["When writing about people with disabilities, use language that respects their personhood and avoids unintentional bias."],["Use people-first language (\"person with a disability\") unless you know a specific community prefers identity-first language (\"disabled person\")."],["Avoid euphemisms, patronizing terms, and language that centers the disability instead of the person."],["Prioritize respectful and accurate representation by researching community preferences for identification and description."]]],["When discussing disability, prioritize respectful language. Avoid terms like \"normal\" or \"victim,\" instead using \"nondisabled\" or \"living with.\" Center the individual by saying \"people with disabilities\" rather than \"the disabled.\" While person-first language is often preferred, understand that some communities, like Deaf and neurodivergent individuals, prefer identity-first language. Research a community's preferences before writing about them, and refer to resources on inclusive documentation.\n"]]