[gnome-klotski/wip/mallard-help-merge: 13/33] help: rephrased the steps in scores.page



commit 59fd8be7142738362c9cfcbf1fce1d394264f530
Author: Rashi Aswani <aswanirashi19 gmail com>
Date:   Thu Jul 3 16:10:20 2014 +0530

    help: rephrased the steps in scores.page

 help/C/scores.page |   20 +++++++++-----------
 1 files changed, 9 insertions(+), 11 deletions(-)
---
diff --git a/help/C/scores.page b/help/C/scores.page
index cf01435..6f0db06 100644
--- a/help/C/scores.page
+++ b/help/C/scores.page
@@ -14,23 +14,21 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"; />
 
+    <desc>Check your performance.</desc>
+
   </info>
 
   <title>Scores</title>
 
-  <p>You can compare your performance by looking at the number of moves you
-  took in solving each puzzle in the previous games. To view your number of
-  moves:</p>
-  <!-- Rephrase, this language is commanding for documentation. Start with "To check your performance..." 
and keep the sentence simple. -->
+  <p>You can check your performance by looking at the number of moves you
+  have made in the previous games. To view your scores:</p>
     <steps>
       <item><p>Select <guiseq><gui style="menu">Klotski</gui>
       <gui style="menuitem">Scores</gui></guiseq>.</p></item>
-      <item><p> The dialog will display the <gui>Only 18 steps</gui> puzzle by
-      default, to view other puzzles, select them in the drop down menu at the
-      top of the dialog.</p></item>
-      <!-- Simplify this. Say "The dialog by default displays scores of the "Only 18 Steps" puzzle, to 
view...". Do not say drop down menu or top of the dialog, you are using language to describe UI which is 
bound to change!, just menu is enough. In another sentence say "From the menu, select the puzzle whose scores 
you wish to see.-->
-      <item><p>Click on <gui style="button">OK</gui> to close the scores dialog
-      box.</p></item>
-      <!-- This is what I would write "Click on OK to close <gui>Scores<gui>" -->
+      <item><p>The dialog by default displays scores of the <gui>Only 18
+      Steps</gui> puzzle. To view others, select the puzzle from the
+      menu whose scores you wish to see.</p></item>
+      <item><p>Click on <gui style="button">OK</gui> to close
+      <gui>Scores</gui>.</p></item>
     </steps>
 </page>


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