Long march towards accessibility

Hi Team

LibreOffice has a tool to check some elements of accessibility (a11y) in documents:

Choose Tools - Accessibility check

I ran the tool in a random chapter and found some issues, for example:

- No alt text for graphic ‘Image2’
- The text formatting conveys additional meaning.
- Text contrast is too low.
- Hyperlink text is the same as the link address ‘https://documentation.libreoffice.org/en/

It may be necessary to define a set of rules to address a11y in our chapter. For example, a shorter caption text can serve as 'alt text' of images. Other issues may demand for a change in formatting and contents display (merged cells in tables).

Let's run the tool in the chapters, within the review process, ensuring we are in the way to turn our guides and other production accessible.

More information on the Help page
https://help.libreoffice.org/master/en-US/text/swriter/01/accessibility_check.html?DbPAR=WRITER#bm_id551630942369429

Cheers

Hi Olivier,

I would agree that we should pay more attention to a11y in our
documentation. However, I feel the Accessibility Check tool needs
additional work to raise it up to a more useable level.

Just some rough basic examples:

* I run the tool on some of my own documents and it shows headings for
all possible issues in the document, not just those that actually do
exist in the document and need consideration. Creating confusion for
inexperienced users.

* The dialog shows 2 instances of items where "The text formatting
conveys additional meaning." is displayed, when the document actually
has a total of 8 identical issues.

* Clicking the "Go to issue" dialog button highlights a 1/2 special
character, which tells the user absolutely nothing about the
accessibility issue, IF ANY.

I haven't yet checked Bugzilla, but I feel this needs to be drawn to the
devs attention.

You are probably aware that the "Help" button in the Accessibility Check
dialog generates a 404 page error.

Regards
Dave

Hi Dave

I'll fix the Help button miss.

I am aware the tool can be less than perfect but the point here is also to practice the tool and generate bugs for improvements. At least we can fix part of the issues raised (e.g "alt" attribute).

I agree that "The text formatting conveys additional meaning." looks broken or is catching false positives.

It also calls for more information on the issues detected, including suggestions to fix. And the Help page is terse.

Regards