[gnome-klotski/mallard-help: 51/52] Review commit: Polish language

[Rashi Aswani <aswanirashi src gnome org>]

commit c7c98c72b8bbaec1ab703992f632a9b305a4d27b
Author: Sindhu S <sindhus live in>
Date:   Tue Jul 8 23:24:11 2014 +0530

    Review commit: Polish language

 help/C/index.page        |    4 +++-
 help/C/introduction.page |    2 +-
 help/C/moves.page        |    1 +
 help/C/puzzles.page      |    4 ++++
 help/C/rules.page        |    4 +++-
 help/C/start-game.page   |    5 +++--
 6 files changed, 15 insertions(+), 5 deletions(-)
---
diff --git a/help/C/index.page b/help/C/index.page
index b0b1bb0..5937330 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -25,7 +25,9 @@
   <p>Slide blocks to solve the puzzle. To know more about the game, visit
   <link xref="introduction">Game introduction</link>. Other help topics
   are grouped together into sections below.</p>
-
+  <!-- I don't think the word visit is appropriate, use "see" -->
+ <!-- The last sentence is not required -->
+ 
   <section id="play" style="2column">
     <title>Playing Klotski</title>
   </section>
diff --git a/help/C/introduction.page b/help/C/introduction.page
index 773f695..9740428 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -3,7 +3,7 @@
       id="introduction">
 
   <info>
-    <link type="guide" xref="index#play"/>
+   <link type="guide" xref="index#play"/>
     <revision version="3.14" date="2014-06-02" status="review"/>
     <link type="seealso" xref="start-game"/>
 
diff --git a/help/C/moves.page b/help/C/moves.page
index c7ec1f8..3a49a37 100644
--- a/help/C/moves.page
+++ b/help/C/moves.page
@@ -25,6 +25,7 @@
   consecutive moves of a block are considered to be a single move. For example,
   moving a block up one square then right two squares is considered one
   move.</p>
+  <!-- First sentence is not required. See also link to scores is enough.-->
 
   <section id="patterned-block-moves">
     <title>Goal piece moves</title>
diff --git a/help/C/puzzles.page b/help/C/puzzles.page
index e138a99..64b2b79 100644
--- a/help/C/puzzles.page
+++ b/help/C/puzzles.page
@@ -18,6 +18,7 @@
 
     <desc>Navigate among puzzles, look at the minimum number of moves to solve
     a puzzle.</desc>
+    <!-- navigate among? say something along the lines of "Browse and learn about various puzzles" -->
 
   </info>
 
@@ -32,6 +33,7 @@
   <title>Navigate among puzzles</title>
 
   <p>To navigate between the puzzles:</p>
+  <!--This sentence is redundant, how is it complementing the title? it seems repeatitive -->
     <steps>
       <item><p>Click on <gui style="button">View Puzzles</gui> in the
       bottom right, choose a category. All the puzzles in the category will
@@ -48,7 +50,9 @@
 
   <p>Each puzzle is different from the other in the manner of, the minimum
   number of moves to solve them and the various positions of the blocks in it.
+  <!--Simplify this sentence, please. Its too verbose and confusing -->
   You can find the minimum number of moves for the various puzzles below.</p>
+  <!-- This is the place you should say "The minimum numer of moves for the various puzzles are:" -->
 
   <table frame="all" rules="rows cols">
     <tr>
diff --git a/help/C/rules.page b/help/C/rules.page
index 2e3b423..c949c37 100644
--- a/help/C/rules.page
+++ b/help/C/rules.page
@@ -22,7 +22,7 @@
   <title>Game rules</title>
 
   <p>These are the rules to follow when sliding blocks:</p>
-
+<!-- This sentence is redundant. Say a line or two about why would we need these rules? would they make the 
game more fun? -->
   <section id="rules">
     <title>Rules to move a block</title>
       <list>
@@ -40,4 +40,6 @@
     board.</p>
   </section>
 
+  <!--This information should be at the top of the page, it makes sense that user knows how to play by 
making a move and then look at rules -->
+
 </page>
diff --git a/help/C/start-game.page b/help/C/start-game.page
index 981f178..b36cba8 100644
--- a/help/C/start-game.page
+++ b/help/C/start-game.page
@@ -1,7 +1,7 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
       id="start-game">
-
+<!--Did i mention something about this file name? rename it to start.page -->
   <info>
     <link type="guide" xref="index#play"/>
     <link type="seealso" xref="rules"/>
@@ -25,6 +25,7 @@
 
   <p><app>Klotski</app> offers a large collection of games, to play a new
   game:</p>
+  <!-- This should be in steps!! -->
   <p>Select <guiseq><gui style="menu">Klotski</gui>
   <gui style="menuitem">New Game</gui></guiseq>.
   Alternatively, you can click the <gui style="button">Start Over</gui>
@@ -33,7 +34,7 @@
 
   <section id="play-different-puzzles">
   <title>Play a different puzzle</title>
-
+<!--Split this into steps -->
     <p>To play a different puzzle, click the <gui style="button">View
     Puzzles</gui> button, choose a game category and start a new puzzle by
     double clicking on it.</p>