[gnome-terminal/mallard-help] help: review adv-keyboard-shortcuts.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 1a1adeaf054acff110fbcc86beeee9e71cf8b47c
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Thu Feb 14 22:05:44 2013 +0000

    help: review adv-keyboard-shortcuts.page

 help/C/adv-keyboard-shortcuts.page |   39 +++++++++++++++++++++++++----------
 1 files changed, 28 insertions(+), 11 deletions(-)
---
diff --git a/help/C/adv-keyboard-shortcuts.page b/help/C/adv-keyboard-shortcuts.page
index f9a8dd7..9393808 100644
--- a/help/C/adv-keyboard-shortcuts.page
+++ b/help/C/adv-keyboard-shortcuts.page
@@ -12,29 +12,46 @@
       <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>View and edit keyboard shortcuts.</desc>
+    <desc>View and edit keybindings.</desc>
   </info>
 
-  <title>Keybindings</title>
+<!-- Try to use titles that match the page IDs, I have updated the title and description to reflect this. -->
+
+  <title>Keyboard shortcuts</title>
 
-  <note style="important"><p>This page assumes you are using the default shell, Bash. </p></note>
+  <note style="important">
+    <p>This page assumes you are using the default shell, <app>Bash</app>.</p>
+  </note>
 
-  <p>Keyboard shortcuts are combination of keys to directly bring up a
-  <app>Terminal</app> settings dialog or access a feature inside
-  <app>Terminal</app>. These shortcuts can be modified to suit your
-  requirements. To change the default keyboard shortcuts, go to to <guiseq><gui
+<!-- Make sure you don't leave spaces between tag content and tags! Mark up
+     apps with <app> tags. -->
+
+  <p>Keyboard shortcuts are combinations of keys that allow you to perform some actions, such as opening the 
settings dialog or accessing a feature inside
+  <app>Terminal</app>, more quickly. These shortcuts can be modified to suit your
+  requirements.</p>
+  
+<!--  To change the default keyboard shortcuts, go to to <guiseq><gui
   style="menu">Edit</gui><gui style="menuitem">Preferences</gui><gui
   style="tab">Keybindings</gui></guiseq>.</p>
 
-  <p>Default Shortcuts are:</p>
-  <!--TODO fill default shortcuts -->
-
   <p>To change the default shortcuts, select the shortcut by double clicking on
   it. Press your desired choice of combination of keys, this will register with
   <app>Terminal</app> as the shortcut for the selection.</p>
 
+  Put the above in to a steps list! -->
+
+  <p>The default shortcuts are:</p>
+  <!--TODO fill default shortcuts -->
+
+<!-- Use a table. -->
+
   <p>Shell specific keyboard shortcuts: Ctrl+W - erases a word Ctrl+U - erase
-the line Ctrl+R - bring up search tool</p>
+  the line Ctrl+R - bring up search tool.</p>
 
 </page>