Review adding bookmarks page

See bug 703365

1 files changed, 19 insertions, 30 deletions

diff --git a/help/C/bookmark-add.page b/help/C/bookmark-add.page
index 28a26fc32..a7bef0210 100644
--- a/help/C/bookmark-add.page
+++ b/help/C/bookmark-add.page
@@ -5,7 +5,7 @@
 
   <info>
     <link type="guide" xref="index#bookmark"/>
-    <revision pkgversion="3.10" date="2013-06-30" status="review"/>
+    <revision pkgversion="3.10" date="2013-06-30" status="incomplete"/>
 
     <credit type="author copyright">
       <name>Aruna Sankaranarayanan</name>
@@ -13,9 +13,9 @@
       <years>2013</years>
     </credit>
     <credit type="copyright editor">
-      <name></name>
-      <email its:translate="no"></email>
-      <years></years>
+      <name>Ekaterina Gerasimova</name>
+      <email its:translate="no">kittykat3756@gmail.com</email>
+      <years>2013</years>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
@@ -25,8 +25,7 @@
 
   <title>Bookmark a page</title>
 
-  <p>Bookmarking a page stores it in the <app>Web</app> history, and saves you
-  the hassle of remembering sites that you want to visit again.</p>
+  <p>Bookmark a page to store it permanently and access it quickly.</p>
 
   <steps>
     <title>To add a bookmark:</title>
@@ -35,40 +34,30 @@
     </item>
     <item>
       <p>Select
-      <guiseq><gui style="menu"><link xref="super-menu">Super menu</link></gui>
+      <guiseq><gui style="menu">**geary**</gui>
       <gui style="menuitem">Bookmarks</gui>
       <gui style="menuitem">Add Bookmark…</gui></guiseq> or
       press <keyseq><key>Ctrl</key><key>D</key></keyseq> to add a bookmark.</p>
     </item>
     <item>
-      <p>Type a title for your bookmark in the <gui>Title</gui> text
-      box, so that you can identify it easily in the future.</p>
+      <p>Name your bookmark in the <gui>Title</gui> text entry field, so that
+      you can identify it easily in the future.</p>
     </item>
     <item>
-      <p>Check any topics that your bookmark may be classified under in the
-      list of topics. If the topic of your choice does not exist, type in the
-      name of the topic in the <gui>Topic</gui> text box, and select
-      <gui style="group">Create Topic <input>"Topic name"</input></gui> from
-      the list.</p>
-      <note style="tip">
-	<p>You can also use the <gui>Topic</gui> text box to search for
-	existing topics if your current list of topics is very long.</p>
-      </note>
+      <p>Start typing the topic that you would classify the bookmark under and
+      select it once it is shown. If it does not exist, select <gui>Create
+      topic "<input>Topic name</input>"</gui> from the list. Separate different
+      topic names with commas.</p>
     </item>
     <item>
-      <p>Click <gui style="button">Add</gui> to add your bookmark, or
-      <gui style="button">Cancel</gui> if you do not want to add the
-      bookmark.</p>
-      <note style="info">
-        <p>The <gui style="button">Similar</gui> button displays the number of
-	existing bookmarks for the website you are trying to remember. If there
-	is at least one existing bookmark, the
-	<gui style="button">Similar</gui> button becomes clickable.
-	You can then click it to check the list of similar bookmarks.
-	You can further select any of the similar bookmarks from the list
-	to view their properties.</p>
-      </note>
+      <p>Press <gui style="button">Add</gui> to add the new bookmark.</p>
     </item>
   </steps>
 
+  <p>The <gui style="button">Similar</gui> button displays the number of
+  existing bookmarks for the page which you are adding. If there is at least
+  one existing bookmark, the <gui style="button">Similar</gui> button becomes
+  clickable. You can then view the existing bookmark or merge it with the new
+  one.</p>
+
 </page>