[gnome-klotski/wip/mallard-help-merge: 77/122] help: shifted 'rules' section above 'move-block' section, updated steps in 'move-block' section in r



commit 4fd1bcc9f5c46e2a0d2fd7cfda88d002909a3e20
Author: Rashi Aswani <aswanirashi19 gmail com>
Date:   Thu Jul 3 16:52:37 2014 +0530

    help: shifted 'rules' section above 'move-block' section, updated steps in 'move-block' section in 
rules.page

 help/C/rules.page |   43 +++++++++++++++++--------------------------
 1 files changed, 17 insertions(+), 26 deletions(-)
---
diff --git a/help/C/rules.page b/help/C/rules.page
index 47f9840..7fdf37c 100644
--- a/help/C/rules.page
+++ b/help/C/rules.page
@@ -5,6 +5,7 @@
   <info>
     <link type="guide" xref="index#play"/>
     <revision version="3.12" date="2014-05-23" status="review"/>
+    <link type="seealso" xref="keyboard-shortcuts"/>
 
     <credit type="author">
       <name>Rashi Aswani</name>
@@ -14,39 +15,29 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"; />
 
+    <desc>How to play <app>Klotski</app>?</desc>
+
   </info>
 
   <title>Game rules</title>
 
-  <p>You have to follow some rules while sliding the blocks in order to solve
-  <app>Klotski</app>. The rules are listed below:</p>
-  <!--Saying "you have to" is a aggressive language for documentation. Rephrase this? To say "These are the 
rules to follow when sliding blocks..." -->
+  <p>These are the rules to follow when sliding blocks:</p>
+
+  <section id="rules">
+    <title>Rules to move a block</title>
+      <list>
+        <item><p>The green blocks and the boundary blocks cannot be moved.</p>
+        </item>
+        <item><p>A block cannot be move over the green blocks. However, it is
+        allowed to move a patterened block.</p></item>
+        <item><p>You can take more than one step in a single move.</p></item>
+      </list>
+  </section>
 
   <section id="move-block">
     <title>Move a block</title>
-      <steps>
-        <item><p>Click on the block to be moved.</p></item> 
-        <!--There would be no click on a touch screen interface if GNOME were to be used on it. Besides, 
Click and Drag is the action to make a move right? So combine first and second instruction to say something 
like "Click and drag and the desired block to a location of your choice on the board" -->
-        <item><p>Move the block to the desired location with the help of
-        mouse.</p></item>
-        <!--mouse? Bring out that checklist please. Doesn't it not say that all help instructions should be 
system agnostic? Rephrase this.-->
-        <item><p>Click on the block again.</p></item>
-        <!--If you combine first and second instuctions, this one won't be required -->
-      </steps>
+    <p>Click and drag the desired block to a location of your choice on the
+    board.</p>
   </section>
 
-
-<!-- This section should be placed first and then "Move a block" section. -->
- <section id="rules">
-   <title>Rules to move a block</title>
-     <list>
-      <!-- Language is a bit negative for documentation. Try to say something like "The green blocks and 
boundary blocks cannot be moved. A block cannot be moved over the green blocks. However, it is allowed to 
move a patterend block. Only a single step is allowed in one move.-->
-       <item><p>You can not move the green blocks and the boundary
-       blocks.</p></item>
-       <item><p>You can not move over a block with the exception that the
-       patterned block can move across the green blocks.</p></item>
-       <item><p>You can take more than one step in a single move.</p></item>
-    </list>
- </section>
-
 </page>


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