You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I did a readability check of our current documentation as part of the accessibility audit.
As a general guideline, most text should aim for approximately an 8th grade reading level or lower. If that is not possible (e.g. highly technical or academic texts), provide a TL;DR in plain English that is an 8th grade reading level or lower.
The following pages need improvement with regards to readability:
If we can't get some texts below 9th grade reading level, we could add links to technologies used (e.g. rails, kafka) for those who are unfamiliar with those terms. In addition, we could add lists, tables, pictures, etc. to ease reading comprehension
However, a college reading level is very concerning and should be addressed ASAP.
I did a readability check of our current documentation as part of the accessibility audit.
As a general guideline, most text should aim for approximately an 8th grade reading level or lower. If that is not possible (e.g. highly technical or academic texts), provide a TL;DR in plain English that is an 8th grade reading level or lower.
The following pages need improvement with regards to readability:
All other pages so far are at an 8th grade level or below!
The text was updated successfully, but these errors were encountered: