[gnome-user-docs] a11y-*: Orca pages, passing the buck to Orca help for now, final

[Shaun McCance <shaunm src gnome org>]

commit 57b69446ef553d61c8c757a1cb2e8e1b425b7f20
Author: Shaun McCance <shaunm gnome org>
Date:   Mon Apr 4 23:29:51 2011 -0400

    a11y-*: Orca pages, passing the buck to Orca help for now, final
    
    I'd really like these pages to have a bit more. Not the full
    Orca help, of course, but basic instructions on starting Orca.
    But it's a moving target for 3.0, and I'm out of time.

 gnome-help/C/a11y-braille.page       |   26 ++++++++++++--------------
 gnome-help/C/a11y-screen-reader.page |   25 +++++++++++--------------
 2 files changed, 23 insertions(+), 28 deletions(-)
---
diff --git a/gnome-help/C/a11y-braille.page b/gnome-help/C/a11y-braille.page
index 6ec3551..ba2fbd1 100644
--- a/gnome-help/C/a11y-braille.page
+++ b/gnome-help/C/a11y-braille.page
@@ -3,31 +3,29 @@
       id="a11y-braille">
   <info>
     <link type="guide" xref="a11y#vision" group="blind"/>
+    <link type="seealso" xref="a11y-screen-reader"/>
 
-    <revision pkgversion="3.0" date="2010-12-14" status="stub"/>
+    <revision pkgversion="3.0" date="2011-04-04" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>Use the <app>Orca</app> screen reader with a refreshable Braille display.</desc>
   </info>
 
   <title>Read screen in Braille</title>
 
+  <p>GNOME provides the <app>Orca</app> screen reader to display the user
+  inferface on a refreshable Braille display. Depending on how you installed
+  GNOME, you might not have Orca installed. <link href="install:orca">Install
+  Orca</link>, then refer to the <link href="ghelp:orca">Orca Help</link> for
+  more information.</p>
+
   <comment>
-    <cite date="2010-12-14" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
+    <cite date="2011-04-04">shaunm</cite>
+    <p>I'd like this page to have more on how to start Orca, then pass
+    off to the Orca help for more information.</p>
   </comment>
-
-  <p>Short introductory text...</p>
-
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
-
 </page>
diff --git a/gnome-help/C/a11y-screen-reader.page b/gnome-help/C/a11y-screen-reader.page
index 7c13fdd..90c8520 100644
--- a/gnome-help/C/a11y-screen-reader.page
+++ b/gnome-help/C/a11y-screen-reader.page
@@ -4,30 +4,27 @@
   <info>
     <link type="guide" xref="a11y#vision" group="blind"/>
 
-    <revision pkgversion="3.0" date="2010-12-14" status="stub"/>
+    <revision pkgversion="3.0" date="2011-04-04" status="final"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
     </credit>
 
-    <desc>XXXXX</desc>
+    <desc>Use the <app>Orca</app> screen reader to speak the user interface.</desc>
   </info>
 
   <title>Read screen aloud</title>
 
+  <p>GNOME provides the <app>Orca</app> screen reader to speak the user
+  interface. Depending on how you installed GNOME, you might not have
+  Orca installed. <link href="install:orca">Install Orca</link>, then
+  refer to the <link href="ghelp:orca">Orca Help</link> for more
+  information.</p>
+
   <comment>
-    <cite date="2010-12-14" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
+    <cite date="2011-04-04">shaunm</cite>
+    <p>I'd like this page to have more on how to start Orca, then pass
+    off to the Orca help for more information.</p>
   </comment>
-
-  <p>Short introductory text...</p>
-
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
-
 </page>