Accessibility Issues in the Koha Manual

From Koha Wiki
Jump to navigation Jump to search

This is a wiki page containing the results of automated accessibility tests on the Koha Manual. The tests were performed at the beginning of April 2024 on the "latest" build of the manual. For Accessibility info relating to development of Koha itself, see https://wiki.koha-community.org/wiki/Accessibility.


Tools used

Results

  • DONE -Contrast is not high enough for text elements, especially the left menu panel using gray text on gray background. Generally the contrast is also not high enough for links, the blue color used is too low contrast to the background (or the text is too small). The notes are also not high contrast enough, especially "note", "important" and "warning". See https://gitlab.com/koha-community/koha-manual/-/issues/44
  • DONE - Links to missing anchors: There are some links in the manual that do not link to the correct anchors. E.g. in circulation the link to <a class="reference external" href="#fastaddpermissions">fast_cataloging</a> does not link to an id #fastaddpermissions because there is none! - Retested and this is now solved since we now have ids for the permissions that we can link to!
  • DONE - Searchbox: the "Search docs" search box should have a submit button as people using some accessibility tech need a submit button to actually be able to use it. See https://gitlab.com/koha-community/koha-manual/-/issues/45
  • Trailing slashes in most HTML elements: seems to be a general problem on most pages. https://validator.w3.org/nu/?doc=https%3A%2F%2Fkoha-community.org%2Fmanual%2Flatest%2Fen%2Fhtml%2Fcirculation.html
    • "Trailing slash on void elements has no effect and interacts badly with unquoted attribute values." for everything from <meta charset... /> to <img... />, to <hr />... etc.
    • This is probably 90% of the W3C error output on any manual page.
  • Focus order (unsure about this one): The focus order is first the heading "Koha manual", then the searchbox, then all of the links in the left menu. That means it takes like 60 tab presses to finally get to the contents of the manual page you are on.
    • I tried using a screenreader and you have to listen to the automated voice reading every single link on the left side every time you go to a new page
    • Seems like a lot to me, but I don't know if it's the expected behaviour that you want to hear all left side page links again when you click on a new page.
    • It was suggested to add a link e.g. before the search box that goes "directly to the content of the page"..? Or maybe there's a better way to organize it
Focus Order on the Patrons page in the Manual - note that "60" means you have to have tabbed 60 times to get there...
Retrieved from "https://wiki.koha-community.org/w/index.php?title=Accessibility_Issues_in_the_Koha_Manual&oldid=34917"