Some problem regarding the accessibility documentation section

[Mathieu Stumpf <psychoslave culture-libre org>]

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/