Orca Documentation

[Phil Bull]

Hi guys,

I've attached the first draft of the Orca accessibility documentation,
and there are *lots* of problems with it. This is the current structure
of the document:

1 . Introduction to Orca
2 . Using Orca
3 . Customizing Orca
4 . Application-specific information
5 . Braille
6 . Keyboard Commands
7 . Troubleshooting

It needs to be reviewed and edited for at least the following common
problems:

 * The </ulink> and </code> tags often needs a space to be inserted
after them, e.g. "</ulink>is" should become "</ulink> is"
 * Many of the <ulink> links refer to 'http://docbook.wikiwikiweb.de'.
Just remove these links for the time being, e.g. "<ulink
url='http://docbook.wikiwikiweb.de/Orca/GUI'>Orca GUI</ulink>" just
becomes "Orca GUI"
 * Keyboard shortcuts such as 'Alt+F1' are often put in between <code>
tags, e.g. <code>Alt+F1</code>. Instead, they should look like this:
<keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>
(note that you _don't_ have to put the '+' in yourself)
 * Spelling and grammar needs to be worked on heavily
 * Change titles so that they make sense

Please don't be afraid of messing the document up - make whatever edits
you think are necessary, even removing material if you like. If in
doubt, please email the ubuntu-doc list to ask for advice, or try the
#ubuntu-doc channel on IRC. We only have until tomorrow at the latest
really, so whatever work you can do on this is very much appreciated -
it absolutely doesn't matter if you don't finish a section or don't have
time to work on it.

I've assigned the following sections to the following people, just so we
don't get any duplication of effort:

Qing - 'Introduction to Orca' and 'Using Orca'
Ben - 'Customizing Orca'
Jon - 'Keyboard commands' and 'Troubleshooting'

Please let me know if you can't work on this for any reason and I can
make alternative arrangements.

Thanks for all of your work guys, you rock!

Thanks again,

Phil

-- 
Phil Bull
http://www.launchpad.net/people/philbull
-------------- next part --------------
A non-text attachment was scrubbed...
Name: AccessOrca.xml.tar.gz
Type: application/x-compressed-tar
Size: 16049 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20070912/de9ef7fe/attachment.bin>