Re: Some problem regarding the accessibility documentation section

[Mathieu Stumpf <psychoslave culture-libre org>]

Also there's a broken link to [20] somewhere in the documentation (grep 
is your friend).

[20] 
https://developer.gnome.org/projects/gap/presentations/GUAD3C/making-apps-accessible/start.html

Le 2013-08-09 12:48, Mathieu Stumpf a écrit :
> Hello,
>
> Reading the accessibily documentation, I noted some problems.
>
> First note that I read the french translation, so no everything maybe
> relevant in the English version. Regarding the access to other
> languages, placing them at bottom of the page is not optimal, at 
> least
> you should place a hidden link ever directly "Switch Language"  or a
> "Go to bottom/site parameter". By the way, the page bottom is
> untranslated. Plus putting an icon representing translation[1] may
> help prodiving more visibility to the option. Also switching language
> won't make you come back to the page where you came before switching.
>
> Now for the more specific problem I met:
>  - in [2], [7], [11], [12], [13], [14], [15], [12] code examples are
> overflowing their boxes and part of it is hidden behind the right TOC
> menu
>  - on [3]
>   - the figure I.1 may be re-drawed with a nicer look, like on [19]
> with tango colors
>   - the page is talking about a GTK+2.0 tutorial while linking to the
> current stable version
>  - on [4]
>   - the page content is realy to short, just like few other before
> and after it. One sentance by page is really… strange.
>   - the page use a "clik here" label, bad practice[5]
>  - [6] have unstranslated parts in the content
>  - [8] and [9] previous links refer to current page instead of the
> previous, seems like "upper level" is took a previous item of the
> first item of a given level
>  - [10] have a "GNOME Feedback Page" link which lead to the same 
> current page
>  - [16], [17]  have very old screenshot
>  - on [18] tables layout may be improved
>  - on [19] the TOC menu is over a part of the figure
>
> Of course I would be happy to help in fixing all that myself if you
> point me to relevant documentation on how to proceed.
>
> Kind regards,
> mathieu
>
> [1] Here are some such an icon examples
>
> https://commons.wikimedia.org/w/index.php?title=Special%3ASearch&search=translation+icon&fulltext=Rechercher
> [2]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp4997136.html.fr#top_bar
> [3]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/gad-how-it-works.html.fr
> [4]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/dev-start-3.html.fr
> [5] http://www.w3.org/QA/Tips/noClickHere
> [6]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp4997136.html.fr#top_bar
> [7]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp4971520.html.fr
> [8]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp4967008.html.fr
> [9]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/dev-start-1.html.fr
> [10]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/index-info.html.fr
> [11]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp4987648.html.en
> [12]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp5011824.html.en
> [13]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp5023456.html.en
> [14]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp5009776.html.fr
> [15]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp5037968.html.fr
> [16]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/gad-font-examples.html.fr
> [17]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/gad-focus-examples.html.fr
> [18]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/gad-checklist.html.fr
> [19]
>
> https://developer.gnome.org/accessibility-devel-guide/stable/idp5518384.html.fr

--
Association Culture-Libre
http://www.culture-libre.org/