SelfHosting week 0, phase 2A, documentation.
There is one thing I find quite uncomfortable on @yunohost documentation: the emojis at the beginning of every chapter. They are very annoying to read for a blind user when going back and forth heading by heading with a screen reader. And, worse, when you attempt to isolate links through the "link list" or "heading list", "element list" whatever name used by screen readers for that feature, you cannot choose an item by initial letter and get into it quickly, from the list that pops up.
The "element list" feature allows a user to press a shortcut and find items of the same type, organized in a list. Links, headings, form controls, etc. So, if it is the table of contents in a documentation website, you have all chapters ordered. You press down arrow in the list, till you find the desired element then press Enter. Or, better, in a normal situation, if you have to choose "domains" for example, you pop up the link list and type "d", then if Domains is the first, you press Enter on it. Or at least, links with that initial are isolated by pressing the letter over and over again till you find the desired one.
But this YunoHost docs are full of those emoticons which maybe are pleasant for sighted folks, but not for blind. Not at all.
#accessibility #a11y #blind #docs #SelfHost #SelfHosting #YunoHost
There is one thing I find quite uncomfortable on @yunohost documentation: the emojis at the beginning of every chapter. They are very annoying to read for a blind user when going back and forth heading by heading with a screen reader. And, worse, when you attempt to isolate links through the "link list" or "heading list", "element list" whatever name used by screen readers for that feature, you cannot choose an item by initial letter and get into it quickly, from the list that pops up.
The "element list" feature allows a user to press a shortcut and find items of the same type, organized in a list. Links, headings, form controls, etc. So, if it is the table of contents in a documentation website, you have all chapters ordered. You press down arrow in the list, till you find the desired element then press Enter. Or, better, in a normal situation, if you have to choose "domains" for example, you pop up the link list and type "d", then if Domains is the first, you press Enter on it. Or at least, links with that initial are isolated by pressing the letter over and over again till you find the desired one.
But this YunoHost docs are full of those emoticons which maybe are pleasant for sighted folks, but not for blind. Not at all.
#accessibility #a11y #blind #docs #SelfHost #SelfHosting #YunoHost
