# data[].attributes.headline
e.g., path to resources is broken in instructions

# data[].attributes.subject
e.g., path to resources is broken in instructions

# data[].attributes.headline
e.g., assuming everyone who uses a tool is familiar with an older version of the tool

# data[].attributes.subject
e.g., assuming everyone who uses a tool is familiar with an older version of the tool

# data[].attributes.headline
e.g., "I never thought anyone would try to use it that way."

# data[].attributes.subject
e.g., "I never thought anyone would try to use it that way."

# data[].attributes.headline
e.g., forgetting that new staffers from another region won't be familiar with specific cultural terms

# data[].attributes.subject
e.g., forgetting that new staffers from another region won't be familiar with specific cultural terms

# data[].attributes.headline
e.g., every instruction states, "He should then..." or even "He or she should then..."

# data[].attributes.subject
e.g., every instruction states, "He should then..." or even "He or she should then..."

# data[].attributes.headline
e.g., assuming it would be too much trouble to write inclusive CMS instructions for older folks with a different frame of reference

# data[].attributes.subject
e.g., assuming it would be too much trouble to write inclusive CMS instructions for older folks with a different frame of reference

# data[].attributes.headline
e.g., the documentation itself is inaccessible to folks using screen readers

# data[].attributes.subject
e.g., the documentation itself is inaccessible to folks using screen readers

# data[].attributes.headline
Too much detail can also be a problem. It can be overwhelming.

# data[].attributes.subject
Too much detail can also be a problem. It can be overwhelming.

# data[].attributes.headline
You must be logged in to see the docs, so you can't get help with logging in. 

# data[].attributes.subject
You must be logged in to see the docs, so you can't get help with logging in. 

# data[].attributes.body
(A real problem in my org, for a long time!)

# data[].attributes.headline
Assuming everyone understands technical jargon

# data[].attributes.subject
Assuming everyone understands technical jargon

# data[].attributes.headline
Using the terms "look," "see," or "view" when you mean "read" 

# data[].attributes.subject
Using the terms "look," "see," or "view" when you mean "read" 

# data[].attributes.body
Different people use different tools to read

# data[].attributes.headline
using jargon or terms not everyone may know

# data[].attributes.subject
using jargon or terms not everyone may know

# data[].attributes.headline
idioms and slang can be difficult, even for people with a great grasp of the language

# data[].attributes.subject
idioms and slang can be difficult, even for people with a great grasp of the language

# data[].attributes.headline
What do you do with outdated or no longer relevant documentation?

# data[].attributes.subject
What do you do with outdated or no longer relevant documentation?

# data[].attributes.body
We have a huge source of documentation for our CMS users and we add new documentation as new features are added, but never ever go back and groom the already existing documentation that is still searchable.

# data[].attributes.body
Documentation refers to third-party tech you don't control ... and then the tech changes.

# data[].attributes.headline
Assuming that people are reading docs in a linear way and not skimming through to find the information that they need. 

# data[].attributes.subject
Assuming that people are reading docs in a linear way and not skimming through to find the information that they need. 

# data[].attributes.headline
Included videos don't have (good or any) captioning

# data[].attributes.subject
Included videos don't have (good or any) captioning

# data[].attributes.body
E.g. science texts with only images of men practicing science.

# data[].attributes.headline
Refers to other knowledge resources that may not be acessible to every reader. Broken links / gated content in corporate network

# data[].attributes.subject
Refers to other knowledge resources that may not be acessible to every reader. Broken links / gated content in corporate network

# data[].attributes.headline
Difficult to find docs; not all in a central place or not well organized

# data[].attributes.subject
Difficult to find docs; not all in a central place or not well organized

# data[].attributes.headline
Assuming people have access to equipment/resources they may not have or be able to afford

# data[].attributes.subject
Assuming people have access to equipment/resources they may not have or be able to afford

# data[].attributes.headline
Assuming excellent internet access-this can be a problem for low-income, geography, etc.

# data[].attributes.subject
Assuming excellent internet access-this can be a problem for low-income, geography, etc.

# data[].attributes.headline
Being overly specific (e.g., style guides that repeat the dictionary entries for various things)

# data[].attributes.subject
Being overly specific (e.g., style guides that repeat the dictionary entries for various things)

# data[].attributes.headline
Mentioning a tool, or method, but not including a guide or link to a refresher for those not acquainted.

# data[].attributes.subject
Mentioning a tool, or method, but not including a guide or link to a refresher for those not acquainted.

# data[].attributes.headline
Learning styles and the assumption if you wrote they will retain the instruction vs people who need to hear, see, or physically do it first

# data[].attributes.subject
Learning styles and the assumption if you wrote they will retain the instruction vs people who need to hear, see, or physically do it first

# data[].attributes.headline
Writing instructions in terms of personnel rather than roles, assuming people will stay on forever and the reader knows who that person is.

# data[].attributes.subject
Writing instructions in terms of personnel rather than roles, assuming people will stay on forever and the reader knows who that person is.

# data[].attributes.body
Example: Ask Meghan if you need help vs. Ask the Director of Marketing if you need help

# data[].attributes.body
(General accessibility overlap)

# data[].attributes.body
Using process/architecture maps to provide lean visualization for users that may learn differently than others

# data[].attributes.body
(Instead of just DMing you every time they forget how to do something.)

# data[].attributes.headline
colorblindness can be a problem for documentation that uses red to highlight issues.

# data[].attributes.subject
colorblindness can be a problem for documentation that uses red to highlight issues.

# data[].attributes.headline
Assuming people know where to go with questions

# data[].attributes.subject
Assuming people know where to go with questions

# data[].attributes.headline
Ignoring that some people use they/them pronouns. It is most accessible to use plural pronouns to write gender inclusive docs.

# data[].attributes.subject
Ignoring that some people use they/them pronouns. It is most accessible to use plural pronouns to write gender inclusive docs.

# data[].attributes.headline
words like 'master' or color words that denote positive/negative

# data[].attributes.subject
words like 'master' or color words that denote positive/negative

# data[].attributes.headline
Cultural references that may not be known by everyone

# data[].attributes.subject
Cultural references that may not be known by everyone

# data[].attributes.headline
Overly technical language  and words that a lot of people aren't familiar with, especially if non-technical people (e.g edit + junior level folks) are using the documentation. 

# data[].attributes.subject
Overly technical language  and words that a lot of people aren't familiar with, especially if non-technical people (e.g edit + junior level folks) are using the documentation. 

# data[].attributes.headline
Swearing and other saucy content-- makes you sound cool in techworld and journoworld, but can also be offensive 

# data[].attributes.subject
Swearing and other saucy content-- makes you sound cool in techworld and journoworld, but can also be offensive 

# data[].attributes.headline
Not including where to find certain folders, documents, etc. 

# data[].attributes.subject
Not including where to find certain folders, documents, etc. 

# data[].attributes.headline
Not having a centralized place for documentation

# data[].attributes.subject
Not having a centralized place for documentation

# data[].attributes.body
Did one person or team write it? If so, is there a plan to maintain it once they're gone or off to the next thing? So much documentation is simply orphaned.

# data[].attributes.headline
Screenshots are helpful, but can go out of date quickly

# data[].attributes.subject
Screenshots are helpful, but can go out of date quickly

# data[].attributes.headline
People know how to access all of the tools and/or personnel they made need to complete a task.

# data[].attributes.subject
People know how to access all of the tools and/or personnel they made need to complete a task.

# data[].attributes.headline
What's the right format for the audience?

# data[].attributes.subject
What's the right format for the audience?

# data[].attributes.body
Documents might seem overwhelming or go un-used. other possible formats: slide deck, short demo videos...

# data[].attributes.headline
When the same instructions don't apply to everyone

# data[].attributes.subject
When the same instructions don't apply to everyone

# data[].attributes.body
ie, an open-source and hosted version of your product

# data[].attributes.body
Does it appear in search results, etc?

# data[].attributes.headline
Women being seen as the note takers/defaulting to asking them to update docs that benefit the entire team

# data[].attributes.subject
Women being seen as the note takers/defaulting to asking them to update docs that benefit the entire team

# data[].attributes.body
Do you need to be on the VPN to access it?
Is it password protected?
Is it in house or a third-party?

# data[].attributes.headline
Product managers writing documentation for their product or feature have a very biased view

# data[].attributes.subject
Product managers writing documentation for their product or feature have a very biased view

# data[].attributes.body
PMs spend their entire work week looking and interacting with their product and feature. This impacts how they come at their documentation. You need to remember that almost no one has as much context as you.

# data[].attributes.headline
Video goes out-of-date so quickly, and is often inaccessible, and then you have to rerecord a video segment or entire video if it changes

# data[].attributes.subject
Video goes out-of-date so quickly, and is often inaccessible, and then you have to rerecord a video segment or entire video if it changes

# data[].attributes.headline
Not accounting for roles and permissions in docs - can the person reading the doc even access the thing

# data[].attributes.subject
Not accounting for roles and permissions in docs - can the person reading the doc even access the thing

# data[].attributes.headline
Older users in my experience often use tablets and can't see/use multiple screens at the same time.

# data[].attributes.subject
Older users in my experience often use tablets and can't see/use multiple screens at the same time.

# data[].attributes.body
Linking something crucial or to a bigger explainer that eventually doesn't work

# data[].attributes.headline
Cultural assumptions like "going to the bar"

# data[].attributes.subject
Cultural assumptions like "going to the bar"

# data[].attributes.body
Adoption of a documentation tool, if it's different from the tools people are already using.

# data[].attributes.body
Referring to specific people as a resource for "more information"

# data[].attributes.body
^Sometimes because the product hasn't been tested on other devices/browsers/etc.

# data[].attributes.headline
directions in which people navigate or read

# data[].attributes.subject
directions in which people navigate or read

# data[].attributes.headline
putting the documentation on a platform that not everyone uses 

# data[].attributes.subject
putting the documentation on a platform that not everyone uses 

# data[].attributes.headline
For language, writing in a tone that's welcoming and interested in guiding, not just sounding smart. 

# data[].attributes.subject
For language, writing in a tone that's welcoming and interested in guiding, not just sounding smart. 

# data[].attributes.body
Can be so confusing

# data[].attributes.headline
Assuming your reader knows how to access the documentation, or easily navigate through the document/storage system

# data[].attributes.subject
Assuming your reader knows how to access the documentation, or easily navigate through the document/storage system

# data[].attributes.headline
Assumption that all people know and are aware of industry frameworks. 

# data[].attributes.subject
Assumption that all people know and are aware of industry frameworks. 

# data[].attributes.headline
Asking the only person of color in a group to check to make sure the language/docs are acceptable to that affinity group

# data[].attributes.subject
Asking the only person of color in a group to check to make sure the language/docs are acceptable to that affinity group

# data[].attributes.headline
font types and colors that appeal to masculine and feminine sensibilities

# data[].attributes.subject
font types and colors that appeal to masculine and feminine sensibilities

# data[].attributes.headline
Not stating at the top who these documents are for.

# data[].attributes.subject
Not stating at the top who these documents are for.

# data[].attributes.body
And for what purpose (by the end of this, you should have a good idea of...)