[gnome-dictionary/wip/help-pages: 7/30] Review definition, index and introduction help

[Sindhu S <sindhus src gnome org>]

commit 2263a6cfc6ecb2cc2d40f4f7c75494ee5aa16c08
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Thu Mar 28 12:28:07 2013 +0000

    Review definition, index and introduction help
    
    Mark index as complete, definition and introduction as candidate (for
    proof reading). Move link from definition:sources to
    sources-guide:definition because definition is complete, sources-guide
    is not.

 help/C/definition.page    |   41 +++++++++++++++++++++++++----------------
 help/C/index.page         |    8 +++-----
 help/C/introduction.page  |   25 ++++++++++++++-----------
 help/C/sources-guide.page |    4 ++--
 4 files changed, 44 insertions(+), 34 deletions(-)
---
diff --git a/help/C/definition.page b/help/C/definition.page
index bbc0ff8..09e6062 100644
--- a/help/C/definition.page
+++ b/help/C/definition.page
@@ -3,41 +3,50 @@
       id="definition">
 
   <info>
-    <revision version="0.1" date="2013-03-23" status="review"/>
+    <revision pkgversion="3.6" version="0.1" date="2013-03-28" status="candidate"/>
     <link type="guide" xref="index#features"/>
-    <!--link type="guide" xref=""/-->
-    <link type="seealso" xref="sources"/>
+
     <credit type="author copyright">
       <name>Sindhu S</name>
       <email>sindhus live in</email>
       <years>2013</years>
     </credit>
+    <credit type="copyright editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Find meanings of words.</desc>
+    <desc>Find the definition of a word or term.</desc>
 
   </info>
 
-  <title>Look up definitions</title>
+  <title>Look up a word or term</title>
 
-  <p>Meanings of words explain their origin, importance and their usage in
-  language. To look up a definition:</p>
+  <p>You can use <app>Dictionary</app> to look up the meaning of a
+  <em>term</em>. A term can be a single word such as <input>apple</input> or a
+  compound word such as <input>chopping board</input>. The search result may
+  also show you the origin, importance and the usage of a word. To look up a
+  term:</p>
 
   <steps>
     <item>
-      <p>In the text entry next to <gui style="button">Look up:</gui>, type the
-      desired term.</p>
+      <p>Type in the term that you want to search for next to
+      <gui>Look up</gui>.</p>
     </item>
     <item>
-      <p>Press <gui style="button">Look up:</gui> or <key>Enter</key> to let
-      <app>Dictionary</app> search the definition from a
-      <link xref="sources-select">selected dictionary source</link>.</p>
+      <p>Press <key>Return</key> or <gui style="button">Look up:</gui> to
+      search.</p>
     </item>
   </steps>
 
-  <note style="tip">
-    <p>You can press <keyseq><key>Ctrl</key><key>T</key></keyseq> and view
-    <link xref="similar-words">similar words</link> to your search term.</p>
-  </note>
+  <p><app>Dictionary</app> will search your selected dictionary source and
+  show you the result from the first dictionary in the source. To view results
+  from the other dictionaries that are in the same source, select
+  <link xref="similar-words"><guiseq><gui style="menu">View</gui>
+  <gui style="menuitem">Similar Words</gui></guiseq></link> to pop up a
+  sidebar that shows all the results.</p>
+
 </page>
diff --git a/help/C/index.page b/help/C/index.page
index 2b7f9a6..b15eb75 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -3,7 +3,7 @@
       id="index">
 
   <info>
-    <revision version="0.1" date="2013-03-23" status="review"/>
+    <revision pkgversion="3.6" version="0.1" date="2013-03-28" status="final"/>
     <title type="link">Dictionary</title>
     <title type="text">Dictionary</title>
 
@@ -19,12 +19,10 @@
   </info>
 
   <title>
-    <media type="image" mime="image/png" src="figures/gnome-dictionary-icon.png">
-    </media>
-    Dictionary Help
+    <media type="image" mime="image/png" src="figures/gnome-dictionary-icon.png" /> Dictionary Help
   </title>
 
-    <section id="features" style="1column">
+  <section id="features" style="1column">
     <title>Features</title>
   </section>
 
diff --git a/help/C/introduction.page b/help/C/introduction.page
index ca5f779..2c44683 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -3,15 +3,19 @@
       id="introduction">
 
   <info>
-    <revision version="0.1" date="2013-03-23" status="review"/>
+    <revision pkgversion="3.6" version="0.1" date="2013-03-28" status="candidate"/>
     <link type="guide" xref="index"/>
-    <!--link type="guide" xref=""/-->
 
     <credit type="author copyright">
       <name>Sindhu S</name>
       <email>sindhus live in</email>
       <years>2013</years>
     </credit>
+    <credit type="copyright editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
@@ -21,19 +25,18 @@
 
   <title>Introduction</title>
 
-  <p><app>Dictionary</app> is a program to search and view definitions of\
-  words, phrases for a language or subject of your choice.
-  <app>Dictionary</app> searches for definitions using a <app>DICT</app>
-  server located on the Internet. The default DICT server is at
-  <link href="http://dict.org";>http://dict.org</link>.</p>
+  <p><app>Dictionary</app> is an application for looking up term definitions.
+  <app>Dictionary</app> searches for definitions using an online
+  <app>DICT</app> server. The default DICT server is at
+  <sys href="http://dict.org";>http://dict.org</sys>.</p>
 
-  <p>If you do not have access to an Internet connection, you can also install
-  offline <app>DICT</app> server.</p>
+  <!--<p>If you do not have access to an Internet connection, you can also install
+  offline <app>DICT</app> server.</p>-->
 
   <figure>
     <title>Dictionary</title>
-    <desc>Screenshot of <app>Dictionary</app></desc>
-    <media type="image" src="figures/gnome-dictionary.png" width="700">
+    <media type="image" src="figures/gnome-dictionary.png">
+      <p>Screenshot showing the <app>Dictionary</app> main window.</p>
     </media>
   </figure>
 </page>
diff --git a/help/C/sources-guide.page b/help/C/sources-guide.page
index 78a3d28..12f75d5 100644
--- a/help/C/sources-guide.page
+++ b/help/C/sources-guide.page
@@ -5,7 +5,7 @@
   <info>
     <revision version="0.1" date="2013-03-06" status="draft"/>
     <link type="guide" xref="index#preferences"/>
-    <!--link type="guide" xref=""/-->
+    <link type="seealso" xref="definition"/>
 
     <credit type="author copyright">
       <name>Sindhu S</name>
@@ -31,4 +31,4 @@
     <title>Manage your dictionary sources</title>
   </section>
 
-</page>
\ No newline at end of file
+</page>