[gnome-klotski/mallard-help: 52/52] help: update help

[Rashi Aswani <aswanirashi src gnome org>]

commit f608b9b850d2fff14c857c279a164075f63e6e0f
Merge: a4ca0a0 c7c98c7
Author: Rashi Aswani <aswanirashi19 gmail com>
Date:   Tue Aug 5 21:56:47 2014 +0530

    help: update help

 gnome-klotski.doap       |    6 +++---
 help/C/index.page        |    5 ++---
 help/C/introduction.page |    1 +
 help/C/moves.page        |    5 ++---
 help/C/puzzles.page      |   11 +++++------
 help/C/rules.page        |   14 ++++++++------
 help/C/start-game.page   |   24 +++++++++++++-----------
 po/POTFILES.skip         |    1 -
 8 files changed, 34 insertions(+), 33 deletions(-)
---
diff --cc help/C/index.page
index b0b1bb0,5937330..6fde127
--- a/help/C/index.page
+++ b/help/C/index.page
@@@ -22,10 -22,12 +22,9 @@@
  
    <title><media type="image" its:translate="no" src="figures/logo32.png">
    Klotski logo</media> Klotski</title>
--  <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 -->
 - 
++  <p>Slide blocks to solve the puzzle. To know more about the game, see
++  <link xref="introduction">Game introduction</link>.</p>
 +
    <section id="play" style="2column">
      <title>Playing Klotski</title>
    </section>
diff --cc help/C/introduction.page
index c9340a9,9740428..b6804de
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@@ -3,7 -3,7 +3,8 @@@
        id="introduction">
  
    <info>
 -   <link type="guide" xref="index#play"/>
++
 +    <link type="guide" xref="index"/>
      <revision version="3.14" date="2014-06-02" status="review"/>
      <link type="seealso" xref="start-game"/>
  
diff --cc help/C/moves.page
index c7ec1f8,3a49a37..2563869
--- a/help/C/moves.page
+++ b/help/C/moves.page
@@@ -21,10 -21,11 +21,9 @@@
  
    <title>Moves</title>
  
--  <p>You can view your number of moves at the top of the game screen. The
--  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
++  <p>The 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 --cc help/C/puzzles.page
index e138a99,64b2b79..1f62ad6
--- a/help/C/puzzles.page
+++ b/help/C/puzzles.page
@@@ -16,8 -16,9 +16,7 @@@
  
      <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"; />
  
--    <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" -->
++    <desc>Browse and learn about puzzles.</desc>
  
    </info>
  
@@@ -31,7 -32,8 +30,8 @@@
  
    <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 -->
++  <p>There are a set of nineteen amazing puzzles, to browse among the
++  puzzles:</p>
      <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
@@@ -46,9 -48,11 +46,8 @@@
  
    <title>Minimum number of moves</title>
  
--  <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.
-   You can find the minimum number of moves for the various puzzles below.</p>
 -  <!--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:" -->
++  <p>The number of moves and the placement of blocks together make each game
++  unique. The minimum number of moves for the various puzzles are:</p>
  
    <table frame="all" rules="rows cols">
      <tr>
diff --cc help/C/rules.page
index 2e3b423,c949c37..b4071dc
--- a/help/C/rules.page
+++ b/help/C/rules.page
@@@ -21,8 -21,8 +21,15 @@@
  
    <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? -->
++  <p>The aim of <app>Klotski</app> is to move the patterened block to a
++   specific location. Some simple rules you must follow while moving:</p>
++  
++  <section id="move-block">
++    <title>Move a block</title>
++    <p>Click and drag the desired block to a location of your choice on the
++    board.</p>
++  </section>
 +
    <section id="rules">
      <title>Rules to move a block</title>
        <list>
@@@ -34,10 -34,12 +41,5 @@@
        </list>
    </section>
  
--  <section id="move-block">
--    <title>Move a block</title>
--    <p>Click and drag the desired block to a location of your choice on the
--    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 --cc help/C/start-game.page
index 981f178,b36cba8..d3b5188
--- a/help/C/start-game.page
+++ b/help/C/start-game.page
@@@ -1,7 -1,7 +1,6 @@@
  <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 -->
++      id="start">
    <info>
      <link type="guide" xref="index#play"/>
      <link type="seealso" xref="rules"/>
@@@ -25,18 -25,19 +24,21 @@@
  
    <p><app>Klotski</app> offers a large collection of games, to play a new
    game:</p>
-   <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>
-   button. It will start a new game of the default puzzle, <gui>Only 18
-   Steps</gui>.</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>
 -  button. It will start a new game of the default puzzle, <gui>Only 18
 -  Steps</gui>.</p>
++  <steps>
++    <item><p>Select <guiseq><gui style="menu">Klotski</gui>
++    <gui style="menuitem">New Game</gui></guiseq>. Alternatively, you can click
++    on <gui style="button">Start Over</gui>. It will start a new game of the
++    default puzzle, <gui>Only 18 Steps</gui>.</p></item>
++  </steps>
  
    <section id="play-different-puzzles">
    <title>Play a different puzzle</title>
- 
-     <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>
 -<!--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>
++  <steps>
++    <item><p>To play a different puzzle, click on <gui style="button">View
++    Puzzles</gui>.</p></item>
++    <item><p>Choose a game category and double click to start playing.
++    </p></item>
++  </steps>
    </section>
  
  </page>