Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGonzalo Odiard <godiard@gmail.com>2013-12-06 14:52:12 (GMT)
committer Gonzalo Odiard <godiard@gmail.com>2013-12-06 14:52:12 (GMT)
commit2eadae88583ca00db0bb14d0d69643b391f54ee9 (patch)
treee52a0eed8309104cecd18ab71c6e28214af29cd0
parent5cbd9f1eb66af298d8c548f083e0b1c8467b7f52 (diff)
Reduce content of Help Activity page
Signed-off-by: Iain Brown Douglas <iain@browndouglas.plus.com>
-rw-r--r--source/help.rst45
1 files changed, 14 insertions, 31 deletions
diff --git a/source/help.rst b/source/help.rst
index 2a88810..9d88f4f 100644
--- a/source/help.rst
+++ b/source/help.rst
@@ -8,15 +8,17 @@ Help displays documentation for Sugar and the XO laptop.
The image above is of the top of the screen, when the Activity Help is running. There is a simple range of tabs and buttons on the top row of the toolbar. Starting from the left, they are:
-* Activity tab or toolbar button.
+1. Activity tab or toolbar button.
-* View toolbar button.
+2. View toolbar button.
-* Home button, brings you back to the index, or contents page.
+3. Home button, brings you back to the index, or contents page.
-* Forward and back buttons.
+4. Back button.
-* Stop, or close the Activity, on the far right of the toolbar.
+5. Forward button.
+
+6. Stop, or close the Activity, on the far right of the toolbar.
Tour of Help
------------
@@ -24,8 +26,11 @@ We see, working clockwise from top left:
.. image :: ../images/HelpComp.png
+1. Activity tab, here you can enter a name for the page or project, the "pencil and book" icon allows :ref:`journal_qa` to provide a description.
+
+ The :doc:`/collaborating`, or sharing, icon is grayed out and not available.
-1. Activity tab, here you can enter a name for the page or project, access the Journal, to provide a description. The :doc:`/collaborating`, or sharing, icon is grayed out and not available. In Help you do not really need to provide a name for the page you are researching, but it allows you to get back to it easily from the :doc:`/journal`.
+ In Help you do not really need to provide a name for the page you are researching, but it allows you to get back to it easily from the :doc:`/journal`.
2. View toolbar button. The buttons are zoom in, zoom out, and enlarge page to *Full screen*.
@@ -43,32 +48,10 @@ We see, working clockwise from top left:
9. Stop, or close the Activity.
-.. _Speak Help:
-
-Speak Help
-----------
-.. image :: ../images/HelpSpeech1.png
-
-You can have Speak, or robot Alice, read aloud, the text in Help. You can select a whole page of Help, and have it read aloud to you while you explore that Activity.
-
-Try it now, Select the text in this frame.
-
-To select text, move the mouse to the top left of the text, there is a green arrow near the correct point. Click the left, or main, mouse button. Move the cursor to the bottom right of the text to select, there is a red arrow near the correct point.
-
-Bring in the :doc:`/frame` with the "Frame key" or F6. Press on the "Speech lips" icon in the bottom of the frame, then press on *Say selected text*. Notice also that there is a pause feature, once *speech* has started.
-
-.. image :: ../images/HelpSpeech2.png
-
-.. _View source:
-
-View source
------------
-
-You can view the *source* of the page you are reading. Bring in the :doc:`/frame` with the "Frame key" or F6. Right click on the Help icon, and select, *View source*. When you read the *source*, you see the simple text, which Help converts into HTML pages. It is quite easy to make further pages.
-
-.. image :: ../images/HelpFrame.png
+Help read aloud
+---------------
-This version of Help can be edited by the user. If you are interested in making documentation using Help please see this page: :doc:`/how_to_help`.
+In help and text based Activities you can have the robot Alice read the page aloud in the background, while you explore the Activity. See :ref:`say_selected_text`
|more| The underlying software used to display Help, and for the user to edit within Help, is Sphinx. To explore the possibilities of documentation made using this software, please follow the link to *Sphinx* in the footnote below.