[gnome-terminal/wip/mallard-merge: 99/271] help: review gs-tabs.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 14e65061e58e52f39014082e1c5a432a1191484e
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Sat Feb 16 19:49:32 2013 +0000

    help: review gs-tabs.page

 help/C/gs-tabs.page |   54 +++++++++++++++++++++++++++++---------------------
 1 files changed, 31 insertions(+), 23 deletions(-)
---
diff --git a/help/C/gs-tabs.page b/help/C/gs-tabs.page
index fb45c9c..cd92aab 100644
--- a/help/C/gs-tabs.page
+++ b/help/C/gs-tabs.page
@@ -11,10 +11,17 @@
       <email>sindhus live in</email>
       <years>2013</years>
     </credit>
+    <credit type="copyright editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
 
-    <desc>Add, remove, reorder <app>Terminal</app> tabs</desc>
+    <!-- Descriptions should always be full sentences, ending in full stops. -->
+    <desc>Add, remove and reorder <app>Terminal</app> tabs.</desc>
   </info>
 
+  <!-- Use British English title capitalisation. -->
   <title>Manage Tabs</title>
 
   <p>You can open multiple tabs to manage your work in <app>Terminal</app>. This
@@ -23,62 +30,64 @@
   window.</p>
 
   <section id="add-tab">
-    <info>
-    </info>
+<!-- No <info> tags for sections :) -->
     <title>Open a new tab</title>
+
     <p>To open a new tab inside your current <app>Terminal</app> window:</p>
     <steps>
       <item>
-        <p>Go to <guiseq><gui style="menu">File</gui></guiseq></p>
-      </item>
-      <item>
-        <p>Select <gui style="menuitem">Open tab</gui>.</p>
+        <p>Select <guiseq><gui style="menu">File</gui>
+       <gui style="menuitem">Open tab</gui></guiseq>.</p>
       </item>
     </steps>
+
+    <!-- Offer the keyboard shortcut as an alternative. -->
+
   </section>
 
   <section id="close-tab">
-    <info>
-    </info>
     <title>Remove a tab</title>
+
     <p>To close an existing tab inside your current <app>Terminal</app>
     window:</p>
     <steps>
       <item>
-        <p>Go to <guiseq><gui style="menu">File</gui></guiseq></p>
-      </item>
-      <item>
-        <p>Select <gui style="menuitem">Close tab</gui>.</p>
+        <p>Select <guiseq><gui style="menu">File</gui>
+       <gui style="menuitem">Close tab</gui></guiseq>.</p>
+       <!-- Is <gui>Close tab</gui> really lower case? Double check. -->
       </item>
     </steps>
-    <p>Alternatively, you can click on the <gui styele="button">X</gui> on the
+
+    <p>Alternatively, you can click on the <gui style="button">X</gui> on the
     right most corner of the tab.</p>
+
   </section>
 
   <section id="reorder-tab">
-    <info>
-    </info>
-    <title>Change the order of tabs in a <app>Terminal</app> window</title>
+    <!-- Titles should always be concise and short (unless that is not
+    possible). -->
+    <title>Reorder tabs</title>
     <p>To change the ordering of tabs in a window:</p>
     <steps>
       <item>
         <p>Click and hold the left mouse button on the tab.</p>
       </item>
       <item>
-        <p>Drag the tab to the desired position among the other tabs.</p>
+        <p>Drag the tab to the desired position amongst the other tabs.</p>
       </item>
       <item>
         <p>Release the mouse button.</p>
       </item>
     </steps>
     <p>The tab will be placed in the position closest to where you released the
-    tab, immediately beside other opened tabs.</p>
+    tab, immediately beside other open tabs.</p>
+    <!-- What about the right click menu? -->
+
   </section>
 
   <section id="move-tab-another-window">
-    <info>
-    </info>
     <title>Move a tab to another <app>Terminal</app> window</title>
+
     <p>If you want to move a tab from one window to another:</p>
     <steps>
       <item>
@@ -97,9 +106,8 @@
   </section>
 
   <section id="move-tab-create-window">
-    <info>
-    </info>
     <title>Move a tab to create a new <app>Terminal</app> window</title>
+
     <p>To create a new window from an existing tab:</p>
     <steps>
       <item>