[gnome-games] Edits for review



commit 84056ed5ed8c968c848686c2a7d0f47fa7cb8aa3
Author: Michael Hill <mdhill src gnome org>
Date:   Fri Feb 17 07:22:55 2012 -0500

    Edits for review

 mahjongg/help/C/hints.page     |   26 ++++++++++++++++++--------
 mahjongg/help/C/moves.page     |   16 +++++++++++-----
 mahjongg/help/C/pause.page     |   17 +++++++++++------
 mahjongg/help/C/rules.page     |   20 ++++++++++++++------
 mahjongg/help/C/shortcuts.page |   10 +++++++++-
 mahjongg/help/C/strategy.page  |   37 ++++++++++++++++++++++++++++---------
 mahjongg/help/C/toolbar.page   |   13 +++++++++++--
 mahjongg/help/C/translate.page |   36 +++++++++++++++++++++---------------
 8 files changed, 123 insertions(+), 52 deletions(-)
---
diff --git a/mahjongg/help/C/hints.page b/mahjongg/help/C/hints.page
index be21227..97ed3de 100644
--- a/mahjongg/help/C/hints.page
+++ b/mahjongg/help/C/hints.page
@@ -13,6 +13,10 @@
     <name>Tiffany Antopolski</name>
     <email>tiffany antopolski gmail com</email>
    </credit>
+   <credit type="editor">
+     <name>Michael Hill</name>
+     <email>mdhillca gmail com</email>
+   </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
@@ -20,15 +24,21 @@
 
   <title>Hints</title>
 
-  <p>
-	<gui>Hint</gui> highlights two tiles that can be matched. If you have already selected one tile, it will show a match for that piece if one exists.
-  </p>
-  <p>
-        Hint can be accessed by clicking <guiseq><gui>Game</gui><gui>Hint</gui></guiseq>. Alternatively, use the <gui>Hint</gui> button in the <link xref="toolbar">toolbar</link>, or press <keyseq><key>Ctrl</key><key>H</key></keyseq>.
-  </p>
+  <p><gui>Hint</gui> highlights two tiles that can be matched. If you have
+  already selected one tile, it will show a match for that piece if one
+  exists.</p>
+
+  <p><gui>Hint</gui> can be accessed by clicking
+   <guiseq><gui>Game</gui><gui>Hint</gui></guiseq>. Alternatively, use the
+   <gui>Hint</gui> button on the <link xref="toolbar">toolbar</link>, or press
+   <keyseq><key>Ctrl</key><key>H</key></keyseq>.</p>
+
+  <note>
+    <p><gui>Hint</gui> can make Mahjongg too easy, and should be used
+     sparingly.</p>
+    <p>There is a 30-second penalty for each use of the "hint" option.</p>
+  </note>
 
-  <note><p><gui>Hint</gui> can make Mahjongg too easy, and should be used sparingly.</p>
-  <p>There is a 30 second penalty for each use of the "hint" option.</p></note>
   <section id="hints-video">
     <title>Video demonstation</title>
     <media type="video" width="500" mime="application/ogg" src="figures/hints-video.ogv">
diff --git a/mahjongg/help/C/moves.page b/mahjongg/help/C/moves.page
index f36bd61..cfe0f1e 100644
--- a/mahjongg/help/C/moves.page
+++ b/mahjongg/help/C/moves.page
@@ -10,6 +10,10 @@
     <name>Chris Beiser</name>
     <email>ctbeiser gmail com</email>
    </credit>
+   <credit type="editor">
+     <name>Michael Hill</name>
+     <email>mdhillca gmail com</email>
+   </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
@@ -17,10 +21,12 @@
 
   <title>Moves left</title>
 
-  <p>The <gui>Moves Left</gui> counter is located in the <link xref="toolbar">toolbar</link>. It displays the number of different moves that can be made. It can help you see how far you are from running out of moves, and whether you've seen all possible moves.
-  </p>
+  <p>The <gui>Moves Left</gui> counter is located on the
+   <link xref="toolbar">toolbar</link>. It displays the number of different
+   moves that can be made. It can help you see how far you are from running out
+   of moves, and whether you've seen all possible moves.</p>
 
-<media type="image" src="figures/moves-left.png">
-  <p>Mahjongg counters</p>
-</media>
+  <media type="image" src="figures/moves-left.png">
+    <p>Mahjongg counters</p>
+  </media>
 </page>
diff --git a/mahjongg/help/C/pause.page b/mahjongg/help/C/pause.page
index a3fa0b1..73ecd3f 100644
--- a/mahjongg/help/C/pause.page
+++ b/mahjongg/help/C/pause.page
@@ -10,6 +10,10 @@
     <name>Chris Beiser</name>
     <email>ctbeiser gmail com</email>
    </credit>
+   <credit type="editor">
+     <name>Michael Hill</name>
+     <email>mdhillca gmail com</email>
+   </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
@@ -17,12 +21,13 @@
 
   <title>Pausing your game</title>
   
-  <p>
-    You can pause your current game using one of the following methods:
-  </p>
+  <p>You can pause your current game using one of the following methods:</p>
+
   <steps>
-    <item><p>Using the <gui>Pause</gui> button on the <link xref="toolbar">toolbar</link>.</p></item>
-    <item><p>Using the <key>Pause</key> key on your keyboard.  Not all keyboards have this key.</p></item>
-    <item><p>Using the <link xref="shortcuts">keyboard shortcut</link>.</p></item>
+    <item><p>The <gui>Pause</gui> button on the
+     <link xref="toolbar">toolbar</link>.</p></item>
+    <item><p>The <key>Pause</key> key on your keyboard.  Not all keyboards
+     have this key.</p></item>
+    <item><p>The <link xref="shortcuts">keyboard shortcut</link>.</p></item>
   </steps>
 </page>
diff --git a/mahjongg/help/C/rules.page b/mahjongg/help/C/rules.page
index 10188a3..840a432 100644
--- a/mahjongg/help/C/rules.page
+++ b/mahjongg/help/C/rules.page
@@ -13,6 +13,10 @@
      <name>Tiffany Antopolski</name>
      <email>tiffany antopolski gmail com</email>
    </credit>
+   <credit type="editor">
+     <name>Michael Hill</name>
+     <email>mdhillca gmail com</email>
+   </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
@@ -20,12 +24,16 @@
 
   <title>Rules</title>
    <list>
-    <item><p>Tiles must be identical to be vanished.</p></item>
-    <item><p>Fully and partially covered tiles can not be matched.</p></item>
-    <item><p>Tiles must have a free long edge in order to be eligible for matching.</p></item>
+    <item><p>Tiles must be identical to be removed.</p></item>
+    <item><p>Fully and partially covered tiles cannot be matched.</p></item>
+    <item><p>Tiles must have a free long edge in order to be eligible for
+     matching.</p></item>
     <item><p>You can undo a move without penalty.</p></item>
-    <item><p>Using the <link xref="hints">hint</link> option adds a 30 second penalty to your time.</p></item>
-    <item><p>If the arrangement does not allow for further tiles to be matched, you will be given the option to shuffle the tiles in order to keep playing.</p></item>
-    <item><p>Shuffling tiles adds a 60 second penalty to your time.</p></item>
+    <item><p>Using the <link xref="hints">hint</link> option adds a 30-second
+     penalty to your time.</p></item>
+    <item><p>If the arrangement does not allow further tiles to be matched, you
+     will be given the option to shuffle the tiles in order to keep
+     playing.</p></item>
+    <item><p>Shuffling tiles adds a 60-second penalty to your time.</p></item>
    </list>
 </page>
diff --git a/mahjongg/help/C/shortcuts.page b/mahjongg/help/C/shortcuts.page
index 3dbf220..b2769cc 100644
--- a/mahjongg/help/C/shortcuts.page
+++ b/mahjongg/help/C/shortcuts.page
@@ -10,6 +10,10 @@
     <name>Chris Beiser</name>
     <email>ctbeiser gmail com</email>
    </credit>
+   <credit type="editor">
+     <name>Michael Hill</name>
+     <email>mdhillca gmail com</email>
+   </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
@@ -36,7 +40,11 @@
        <tr>
           <td><p>Pause</p></td>
           <td><p><key>Pause</key></p>
-              <note><p>Use the <link xref="toolbar">toolbar</link> shortcut if your keyboard does not have a <key>Pause</key> key.</p></note></td>
+              <note><p>Use the <link xref="toolbar">toolbar</link>
+               <gui>Pause</gui> button if your keyboard does not have a
+               <key>Pause</key> key.</p>
+              </note>
+          </td>
        </tr>
        <tr>
           <td><p>Quit</p></td>
diff --git a/mahjongg/help/C/strategy.page b/mahjongg/help/C/strategy.page
index abab3b2..1320f6f 100644
--- a/mahjongg/help/C/strategy.page
+++ b/mahjongg/help/C/strategy.page
@@ -10,22 +10,41 @@
       <email>tiffany antopolski gmail com</email>
       <years>2012</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
     <desc></desc>
   </info>
 
   <title>Strategy</title>
 
-  <p>Since each <link xref="map">tile layout</link> requires a different approach, there is no one universal strategy. However, there are some strategy tips to keep in mind while you play:</p>
+  <p>Since each <link xref="map">tile layout</link> requires a different
+   approach, there is no one universal strategy. However, there are some
+   strategy tips to keep in mind while you play:</p>
 
   <list>
-    <item><p>The general strategy is to keep removing matching tiles in such a way that each removed tile will expose further tiles.  A good strategy would be to expose new tiles with every set of tiles you match and eliminate.</p></item>
-    <item><p>Choosing easily accessible tiles, such as those from the top levels is not beneficial.  This strategy leaves essential tiles under cover, increasing your chances of losing the game.</p></item>
-    <item><p>Since you are <link xref="scoring">scored</link> by how quickly you finish the game, time is the most important factor in the game, so it is important to be fast.</p>
-  <note><list>
-    <item><p>Using the <link xref="hints">hint</link> option adds a 30 second penalty to your time.</p></item>
-    <item><p>Shuffling tiles adds a 60 second penalty to your time.</p></item>
-  </list></note>
-</item>
+    <item><p>The general strategy is to keep removing matching tiles in such a
+     way that each removed tile will expose further tiles.  A good strategy
+     would be to expose new tiles with every set of tiles you match and
+     eliminate.</p></item>
+    <item><p>Choosing easily accessible tiles, such as those from the top levels,
+     is not beneficial.  This strategy leaves essential tiles under cover,
+     increasing your chances of losing the game.</p></item>
+    <item><p>Since you are <link xref="scoring">scored</link> by how quickly you
+     finish the game, time is the most important factor in the game. It is
+     therefore important to be fast.</p>
+
+      <note>
+        <list>
+          <item><p>Using the <link xref="hints">hint</link> option adds a
+           30-second penalty to your time.</p></item>
+          <item><p>Shuffling tiles adds a 60-second penalty to your
+           time.</p></item>
+        </list>
+      </note>
+
+    </item>
   </list>
 </page>
diff --git a/mahjongg/help/C/toolbar.page b/mahjongg/help/C/toolbar.page
index 61820f8..6913919 100644
--- a/mahjongg/help/C/toolbar.page
+++ b/mahjongg/help/C/toolbar.page
@@ -9,13 +9,22 @@
       <email>tiffany antopolski gmail com</email>
       <years>2011</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
 
     <desc></desc>
   </info>
 
   <title>Show/hide the toolbar</title>
-<p>To show or hide the toolbar, click <guiseq><gui>Settings</gui><gui>Toolbar</gui></guiseq>.</p>
 
-<p>The toolbar, located under the menu bar, lets you perform common actions with your mouse. To use a toolbar item, just click on it. The buttons, from left to right, are New Game, Undo Move, <link xref="hints">Hint</link> and Pause.</p>
+  <p>To show or hide the toolbar, click
+   <guiseq><gui>Settings</gui><gui>Toolbar</gui></guiseq>.</p>
+
+  <p>The toolbar, located under the menu bar, lets you perform common actions
+   with your mouse. To use a toolbar item, just click on it. The buttons, from
+   left to right, are <gui>New</gui> Game, <gui>Undo Move</gui>,
+   <link xref="hints">Hint</link> and <gui>Pause</gui>.</p>
 
 </page>
diff --git a/mahjongg/help/C/translate.page b/mahjongg/help/C/translate.page
index 61cb60d..90485e9 100644
--- a/mahjongg/help/C/translate.page
+++ b/mahjongg/help/C/translate.page
@@ -21,19 +21,25 @@
   </info>
 
 <title>Help translate</title>
-<p>
-  The <app>GNOME games</app> user interface and documentation is being translated by a world-wide volunteer community.  You are welcome to participate.
-</p>
-<p>
- There are <link href="http://l10n.gnome.org/module/gnome-games/";>many languages</link> for which translations are still needed.
-</p>
-<p>
-To start translating you will need to <link href="http:l10n.gnome.org">create an account</link> and join the <link href="http://l10n.gnome.org/teams/";>translation team</link> for your language. This will give you the ability to upload new translations.
-</p>
-
-<p>
-  You can chat with GNOME translators using <link href="https://cbe003.chat.mibbit.com/?url=irc%3A%2F%2Firc.gnome.org%2Fi18n";>irc</link>. People on the channel are located worldwide, so you may not get an immediate response as a result of timezone differences.
-</p>
-<p>Alternatively, you can contact the Internationalization Team using their <link href="http://mail.gnome.org/mailman/listinfo/gnome-i18n";>mailing list</link>.
-</p>
+
+  <p>The <app>GNOME Games</app> user interface and documentation is being
+   translated by a world-wide volunteer community.  You are welcome to
+   participate.</p>
+
+  <p>There are <link href="http://l10n.gnome.org/module/gnome-games/";>many
+   languages</link> for which translations are still needed.</p>
+
+  <p>To start translating you will need to
+   <link href="http:l10n.gnome.org">create an account</link> and join the
+   <link href="http://l10n.gnome.org/teams/";>translation team</link> for your
+   language. This will give you the ability to upload new translations.</p>
+
+  <p>You can chat with GNOME translators using
+   <link href="https://cbe003.chat.mibbit.com/?url=irc%3A%2F%2Firc.gnome.org%2Fi18n";>irc</link>.
+   People on the channel are located worldwide, so you may not get an immediate
+   response as a result of timezone differences.</p>
+
+  <p>Alternatively, you can contact the Internationalization Team using their
+   <link href="http://mail.gnome.org/mailman/listinfo/gnome-i18n";>mailing
+   list</link>.</p>
 </page>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]