about:manual semantic and accessibility problems
I didn't look through all the "about:manual" pages, but I noticed a few semantic and accessibility issues which I imagine are common to most pages. A few of these issues would apply to https://tb-manual.torproject.org/ as well tpo/web/manual#132.
- The top page "about:manual" uses
<h3>
for the "Topics" heading even though it is the top-most heading. - The list of links in "about:manual" uses
<li><h4><a></a></h4><p></p></li>
. Using both<li>
,<h4>
and<a>
for the heading makes this noisier than necessary on a screen reader. Plus, this page is less "headings with paragraphs" and more a navigation page. - The sub-pages start with a
<h2>
heading, rather than<h1>
. - The
<nav>
element at the top of the page could perhaps use<ul>
to separate the links. The "»" symbol should be visual only. - The alt text for
<img>
elements are not very descriptive of the image. A lot of these are screenshots, but don't describe themselves as screenshots. - Some of the text is geared towards users who can see the screenshots.
An example for point 6 would be in the "about:manual#running-tor-browser" page. We have
CONFIGURE
Tor Browser will take you through a series of configuration options.
The Connection Assist informs you about the state of your Internet connection and your connection to the Tor network.
[image]
[image]
The first checkbox is 'Quickstart'. If selected, every time you open Tor Browser, it will try to connect with your previous network settings.
There's no indication that this "configure" is in the settings page, or that "Connection" and "Quickstart" are sections of this page. Using good alt text would help a little, but making the text clearer would help clarify things for all users. Generally, you want something that you could directly read over the phone to help someone on the other end.
Moreover, the use of "Connection Assist" is confusing because the section just before is called "CONNECTION ASSIST", which is something else.