Orca Documentation

[Bhuvaneswaran A]

On 9/12/07, Phil Bull <philbull at gmail.com> 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:

It is a nice and useful document indeed. What stops us to commit this
in our repository? I think, we can commit this document in our
repository and fix all problems mentioned by Phil (and even more).

Comments?

>
>  * 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
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>
>
>


-- 
Regards,
Bhuvaneswaran A
www.livecipher.com
GPG: 0x7A13E5B0