Orca Documentation

[Ben]

i've attached a file that contains just the customizing orca section of 
the article. I've corrected the errors that you mentioned, and modified 
a bit of the content as well as doing a ton of work on formatting. this 
is my second patch, so if i've missed anything please tell me. However, 
i most likely won't be able to do anything tomorrow, as it is Rosh 
Hashana, the jewish new year, and i will be in services for the better 
part of the day.
Phil Bull wrote:
> 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 

Phil Bull wrote:
> 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
>
>   

-------------- next part --------------
A non-text attachment was scrubbed...
Name: AccessOrca.partial.xml.tar.gz
Type: application/x-gzip
Size: 7535 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20070912/c0d30705/attachment.bin>