After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 326985 - Update to the Accessibility Guide
Update to the Accessibility Guide
Status: RESOLVED FIXED
Product: gnome-user-docs
Classification: Core
Component: access-guide
2.4
Other All
: Normal minor
: ---
Assigned To: irene.ryan
irene.ryan
AP1
Depends on: 318056
Blocks:
 
 
Reported: 2006-01-14 19:58 UTC by Don Scorgie
Modified: 2006-08-18 10:47 UTC
See Also:
GNOME target: ---
GNOME version: 2.13/2.14


Attachments
Fix some of the basic stuff (11.63 KB, patch)
2006-01-14 20:04 UTC, Don Scorgie
none Details | Review
Update (15.48 KB, patch)
2006-01-15 17:51 UTC, Don Scorgie
none Details | Review
The "Missing Figure" (1.38 KB, image/png)
2006-01-15 17:52 UTC, Don Scorgie
  Details
Explained what moving the sliders do when configuring the mouse (16.41 KB, patch)
2006-01-15 18:48 UTC, Og Maciel
none Details | Review
Once more (18.22 KB, patch)
2006-01-28 13:30 UTC, Don Scorgie
committed Details | Review
Update to the Key Nav section (7.64 KB, patch)
2006-01-28 19:14 UTC, Don Scorgie
none Details | Review
Reinclude the File Manager Section (10.20 KB, patch)
2006-02-19 11:04 UTC, Don Scorgie
none Details | Review
Update to the theme section (12.52 KB, patch)
2006-02-19 12:43 UTC, Don Scorgie
committed Details | Review
Update the ATS section (2.81 KB, patch)
2006-02-19 14:08 UTC, Don Scorgie
committed Details | Review
Updated Keynav section (10.82 KB, patch)
2006-02-28 19:07 UTC, Don Scorgie
committed Details | Review

Description Don Scorgie 2006-01-14 19:58:31 UTC
Documentation 
Section: 
The patch is for the Mouse and Keyboard section.  Currently it is horribly out
of date.  This patch fixes some of the larger issues.  There are still many I
want to fix.  Applies to dtconfig.xml.

More info in a second

Correct version:


Other information:
Comment 1 Don Scorgie 2006-01-14 20:04:01 UTC
Created attachment 57362 [details] [review]
Fix some of the basic stuff

Mostly the patch changes instances of Applications->Desktop Preferences to System->Preferences.
It also removes most of the bit about choosing cursor sizes and instead mentions cursor themes (although not very well at the moment).

The section on keyboard a11y changes the menus to point to the current location of the options dalog.  Since all these options are now instant apply, references to logging out and in again have been removed, where applicable.  There are now references in the notes to state that confirmation dialogs will appear before turning on a11y function from the keyboard.
Comment 2 Don Scorgie 2006-01-15 17:51:10 UTC
Created attachment 57414 [details] [review]
Update

This updates this section some more, replacing the previous patch.

Some highlights: Removed the two tables for mousekeys and replaced by one since they basically said the same thing.  Added a little more about how mouse button clicking works using mousekeys.

Theres also a missing image that I'll attach in a minute.
Comment 3 Don Scorgie 2006-01-15 17:52:04 UTC
Created attachment 57415 [details]
The "Missing Figure"

Required image to show the default state for the accessX applet
Comment 4 Og Maciel 2006-01-15 18:48:44 UTC
Created attachment 57418 [details] [review]
Explained what moving the sliders do when configuring the mouse

Explained what moving the sliders do when configuring the mouse for double-click and mouse pointer sensitivity.
Comment 5 Og Maciel 2006-01-15 19:15:16 UTC
Will change patch to add the words "increment" and "decrement" for the adjustment of mouse sensitivity and double-click response.
Comment 6 Don Scorgie 2006-01-28 13:30:31 UTC
Created attachment 58259 [details] [review]
Once more

Another update to the Keyboard & Mouse section to fix a couple of problems with the last patch.

This one removes the Ubuntuism of System and changes it to Desktop.  It also changes all occurrences of "Cursor" to "Pointer" for Mouse related stuff and adds a note about GNOME not including mouse themes by default (and points to the user guide for adding more themes).  This isn't ideal, but until GNOME ships with pointer themes or someone comes up with better wording, it'll have to do ;)
Comment 7 Don Scorgie 2006-01-28 19:14:50 UTC
Created attachment 58276 [details] [review]
Update to the Key Nav section

A much smaller patch for this section.  Not much here, a few comments clarified.  A few obsolete key combos removed.  A fairly large change is the removal of the section "Navigating the File Manager" as it refers soley to the navigational mode and doesn't mention anything about Spatial mode.
Comment 8 bill.haneman 2006-01-30 10:28:04 UTC
Hmm, navigational mode is still available as an option, isn't it?  Not sure we should remove that stuff entirely from the docs...
Comment 9 Joachim Noreiko 2006-02-06 20:30:58 UTC
This patch might make Bug 138289 obsolete.
Comment 10 Brent Smith (smitten) 2006-02-14 05:15:47 UTC
What is the status of this patch?  Can it be committed or do some changes need to be made related to comment 8?
Comment 11 Don Scorgie 2006-02-18 17:20:35 UTC
I've committed the first patch (for the Mouse and Keyboard section) since there didn't seem to be any objections.

I'll rework the "Navigating the File Manager" section to include both spatial and navigational mode.
Comment 12 Don Scorgie 2006-02-19 11:04:49 UTC
Created attachment 59695 [details] [review]
Reinclude the File Manager Section

Adds back in the File manager section to the KeyNav section.

Splits it into 2 subsections - "To Navigate in Spatial Mode" and "To Navigate in Navigational Mode".
Comment 13 Don Scorgie 2006-02-19 12:43:06 UTC
Created attachment 59705 [details] [review]
Update to the theme section

This updates the themes section.  It replaces <citetitle>s with links to the relevant documents and brings menu options up to date etc.

It does remove 2 subsections - "To Customize the File Manager Font" and "To Customize the Text Editor Font" and replaces them with a new section "To Customize Application Fonts" that provides links to manuals where the information is supplied.  The apps listed are "Help Browser" - with no link at the moment, "Text Editor" - with a link to the gedit manual, "Terminal" - link to gnome-terminal manual and "Web Browser" - link to epiphany manual.
Comment 14 Don Scorgie 2006-02-19 14:08:41 UTC
Created attachment 59709 [details] [review]
Update the ATS section

Very small patch for this section.  Adds links to the GOK and gnopernicus manuals at the relevant places.  Updates the screensaver to reflect the added simplicity from gnome-screensaver (i.e. remove almost all the instructions and replace with Deselect the "Activate the screensaver when idle" checkbox.)
Comment 15 Joachim Noreiko 2006-02-27 18:52:36 UTC
Comments on #12:

For the UG link, id "nautilus-presentation" is the page that explains spatial and browser mode.
Also, the UG uses the term "browser mode", not "Navigational mode". Which one is correct?

The spatial mode shortcuts don't mention Home and End.
Should all shortcuts be mentioned? THere are a few others for open parent.

I'm not sure about the distinction anyway. All the stuff in "3.7.1. To Navigate in Spatial Mode" also applies to a folder in a browser window.
A better structure might be common shortcuts first, then navigational-specific ones.

3.7.1. To Navigate a Folder
3.7.2 To Navigate Browser Window components
...etc

Question: how do I use the keyboard to select non-contiguous items, the way I would with CTRL-mouse click? What is the keyboard shortcut to select the currently focused icon? There ought to be one. (If not, file bug :)

Should there be a paragraph that explains the difference between 'selected' and 'focussed'? Or is this elsewhere in the a11y guide?
Comment 16 Don Scorgie 2006-02-28 19:07:00 UTC
Created attachment 60341 [details] [review]
Updated Keynav section

Incorporating Joachim's comments.
Comment 17 Joachim Noreiko 2006-02-28 21:54:58 UTC
#16:
s/seperate/separate/, but otherwise looks great.

#13:
See Bug 332879.
Links to the user guide:

"prefs-theme" (in the table, and the term "Theme Preferences dialog" in "4.2.2. To Choose a Theme".

"nautilus-backgrounds-and-emblems", in the table. I've previously linked to it like this: <link linkend="nautilus-backgrounds-and-emblems"><guilabel>Backgrounds
and Emblems</guilabel> dialog</link> in the <application>Nautilus</application> file manager.

"prefs-desktopbackground" 
"prefs-font" (just updated that one in CVS)

#14:
Looks fine. I can't check the links as I don't have those apps installed.
Comment 18 Don Scorgie 2006-03-01 19:32:21 UTC
Hi,

I've committed the patches from comments #16 and #14.  For #13, I've changed the theme names as suggested by bug #332879.  I haven't added any more links other that what was in the patch originally.  I had a look at where (I think) you wanted to add links.  To me, they don't really need links and adding them breaks up the text a bit.
Comment 19 Joachim Noreiko 2006-03-01 22:37:08 UTC
I thought it would be a good idea to link to help on the tools we mention, such as Theme prefs, or the backgrounds dialog in Nautilus, because that explains how to get to them and how to use them. I thought inline links, rather than an explicit "For more on this, see ..." type link that yes, does break the text up. But it's your call. :)
Comment 20 Calum Benson 2006-04-26 16:57:27 UTC
Apologies for spam-- marking AP1 to reflect accessibility impact.
Comment 21 Calum Benson 2006-04-26 17:09:42 UTC
Apologies for spam... ensuring Sun a11y folks are cc'ed on all current accessibility bugs.
Comment 22 Don Scorgie 2006-08-18 10:47:02 UTC
Updates were all committed a while ago.  Closing.