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
Copy file name to clipboardExpand all lines: docs/source/contrib/style_guide/ftc-docs-accessibility-guidelines.rst
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -89,9 +89,9 @@ Success Criterion 2.4.4 Link Purpose (In Context) - Level A
89
89
90
90
The purpose of each link can be determined from the link text alone or from the link text together with its programmatically determined link context, except where the purpose of the link would be ambiguous to users in general.
91
91
92
-
- FTC Docs has intentially choosen to open links to external sites in new tabs. This is done with Javascript.
92
+
- FTC Docs has intentionally chosen to open links to external sites in new tabs. This is done with JavaScript.
93
93
94
-
This does preserve your current location in FTC Docs and may be convienient for sighted users who can easily close the new tab.
94
+
This does preserve your current location in FTC Docs and may be convenient for sighted users who can easily close the new tab.
95
95
This is an accessibility issue related to unexpected context switching, it also creates a new browser tab that some users might have trouble noticing or closing.
96
96
It also prevents the *back* browser command from working.
97
97
@@ -104,7 +104,7 @@ The purpose of each link can be determined from the link text alone or from the
104
104
**FTC Docs To Do**
105
105
106
106
- We link to some files like a PDF without warning the user. PDFs often result in a context switch to a PDF viewer.
107
-
- I have been surpised a few times when links I thought would be a FTC Docs page actually took me to a PDF or to *FIRST* Inspires web page.
107
+
- I have been surprised a few times when links I thought would be a FTC Docs page actually took me to a PDF or to *FIRST* Inspires web page.
108
108
The Persona Pages are bad for this. There are grid button links that sometimes take you to a ftc-docs page but often take you to another site with no warning.
109
109
Ideally all Persona pages should link to FTC Docs pages, some of which might be Gateway Pages to the main *FIRST* site.
110
110
- See the :ref:`contrib/style_guide/style-guide:links` section of the Style Guide.
@@ -119,7 +119,7 @@ Make it easier for users to operate functionality through various inputs beyond
119
119
120
120
- We might want to enhance functionality for mobile users and other forms of input.
121
121
But we need to be careful not to introduce problems.
122
-
For example, important content in a tooltip that only shows with mouse hover and is not keyboard accessible or accessbile on a mobile device.
122
+
For example, important content in a tooltip that only shows with mouse hover and is not keyboard accessible or accessible on a mobile device.
123
123
124
124
Principle 3 – Understandable
125
125
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -135,7 +135,7 @@ Make text content readable and understandable.
135
135
136
136
- Plain language means communicating in a way that’s clear, straightforward, and easy to understand. It helps audiences “get” what you’re saying immediately. See https://evolvingweb.com/blog/plain-language-guide-how-write-inclusive-digital-content-2024.
137
137
- Some FTC Docs pages have acronyms and excess punctuation that screen readers had trouble with. Revising the text to make it more accessible would make it more readable and understandable for all users.
138
-
- It's ok to discuss a complex subject, but given the wide audience for FTC Docs content authors should consider perhaps a simplified introduction or summary that builds in complexity and/or add links to background information.
138
+
- It's OK to discuss a complex subject, but given the wide audience for FTC Docs content authors should consider perhaps a simplified introduction or summary that builds in complexity and/or add links to background information.
0 commit comments