[gnome-user-docs] Documents, incremental edits

[Michael Hill <mdhill src gnome org>]

commit 9bc2ee0f9c8b380e3cf32f0bff76c76a7b016657
Author: Michael Hill <mdhill src gnome org>
Date:   Sun Sep 2 15:52:18 2012 -0400

    Documents, incremental edits

 gnome-help/C/documents-collection-send.page        |   11 +++-
 gnome-help/C/documents-info.page                   |   53 +++++++++++++-------
 ...-location.page => documents-location.page.stub} |   15 ++----
 .../{documents-online.page => documents-view.page} |    4 +-
 gnome-help/C/documents-viewgrid.page               |   17 +++++--
 5 files changed, 61 insertions(+), 39 deletions(-)
---
diff --git a/gnome-help/C/documents-collection-send.page b/gnome-help/C/documents-collection-send.page
index 1fce6d7..149ee07 100644
--- a/gnome-help/C/documents-collection-send.page
+++ b/gnome-help/C/documents-collection-send.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="documents-collection-send">
   <info>
-    <revision pkgversion="3.4.0" date="2012-02-20" status="stub"/>
+    <revision pkgversion="3.5.90" date="2012-09-02" status="review"/>
 
     <link type="guide" xref="documents#print" />
 
@@ -11,8 +11,13 @@
       <email>yrazes gmail com</email>
       <years>2012</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+      <years>2012</years>
+    </credit>
 
-    <desc>Send by email documents grouped in a collection.</desc>
+    <desc>Email documents grouped in a collection.</desc>
   </info>
 
   <title>Send a document collection to someone</title>
@@ -38,4 +43,4 @@
     <cite date="2012-02-20" href="mailto:yrazes gmail com">Julita Inca</cite>
     <p>I do not know the documents MG size that someone can share by email.</p>
   </comment>
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/documents-info.page b/gnome-help/C/documents-info.page
index c3f8a79..b76d1a1 100644
--- a/gnome-help/C/documents-info.page
+++ b/gnome-help/C/documents-info.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="documents-info">
   <info>
-    <revision pkgversion="3.4.0" date="2012-02-20" status="stub"/>
+    <revision pkgversion="3.5.90" date="2012-09-02" status="review"/>
 
     <link type="guide" xref="documents#view"  group="#last" />
 
@@ -11,9 +11,13 @@
       <email>yrazes gmail com</email>
       <years>2012</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+      <years>2012</years>
+    </credit>
 
-    <desc>See information like owner, type, size, location, number of pages,
-    last accessed and last modified of the document.</desc>
+    <desc>See a document's name, location, date modified, or type.</desc>
   </info>
 
   <title>Find information about documents</title>
@@ -26,24 +30,35 @@
      - Mention that this metadata is searched.</p>
   </comment>
 
-   <p>When you create a document, metadata is also created.
-    Metadata refers information about the document like owner, type, size,
-    location, number of pages, last accessed and last modified of the document.
-    These properties are typically stored, but further information is also added
-    and can be searched. You can currently choose to have the search string
-    apply to everything, or just match the title or the author. To configure it:
-   </p>
+   <p>When a document is created, it comes with <em>metadata</em>.
+    <app>Documents</app> displays the following metadata for each document:</p>
+    
+   <list>
+     <item><p>Title: the name of the document, which can be edited;</p></item>
+     <item><p>Source: the path of the folder containing the document;</p></item>
+     <item><p>Date Modified;</p></item>
+     <item><p>Type: the <link xref="documents-formats">file format</link>
+      of the document.</p></item>
+   </list>
+    
+   <p>To see a document's properties:</p>
    <steps>
-    <item><p>Select <gui>Search</gui> from the dropdown menu that is triggered
-    by pressing the arrow right to the search entry.</p></item>
+    <item><p>Click the <gui>Check</gui> button to switch to selection
+     mode.</p></item>
+    <item><p>Select a document.</p></item>
+    <item><p>Click the <gui>Properties</gui> button at the right end of the </p></item>
    </steps>
 
-   <p>Documents itself does not currently offer any mechanism to add privacy to
-   a document. You are typically able to do this from your content-creation
-   application though (e.g. LibreOffice or Adobe Acrobat).</p>
+   <note style="tip">
+     <p>Some types of documents (e.g. PDF files) can be password protected,
+     preventing access to their metadata or content.</p>
+   </note>
 
-   <note style="tip"><p>Some kind of documents (e.g. PDF files) can be
-   password-protected though, and you would not be able to access all metadata
-   or content for those.</p></note>
+   <note style="info">
+     <p><app>Documents</app> does not currently offer any mechanism to add
+     privacy to a document. You may be able to do this from the application you
+     used to create the document (e.g. <app>LibreOffice</app> or
+     <app>Adobe Acrobat</app>).</p>
+   </note>
 
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/documents-location.page b/gnome-help/C/documents-location.page.stub
similarity index 57%
rename from gnome-help/C/documents-location.page
rename to gnome-help/C/documents-location.page.stub
index ab99ef5..33cde40 100644
--- a/gnome-help/C/documents-location.page
+++ b/gnome-help/C/documents-location.page.stub
@@ -17,7 +17,7 @@
       <years>2012</years>
     </credit>
 
-    <desc>Find out where a document is stored.</desc>
+    <desc>Find out which folder contains a document.</desc>
   </info>
 
   <title>Find where a document is stored</title>
@@ -29,17 +29,12 @@
     a document is stored in (i.e. find its URI).</p>
   </comment>
 
-  <p>Maybe you forget the name of the folder where you have left your documents,
-   but you may remember a word from the name or title, or something about the
-   document you are looking for. <app>Documents</app> lets you locate your
-   documents or collections by searching a word of the title of the document:</p>
+  <p>You may forget the name of the folder where you saved a document. Let
+   <app>Documents</app> tell you where it is:</p>
 
   <steps>
-    <item><p>Click the <gui>Check</gui> button.</p></item>
-    <item><p>Go to the top search menu and write the word to identify your
-      document or collection.</p></item>
-    <item><p>Select the document or collection and right click to see the
-      <gui>Properties</gui> of the document or collection.</p></item>
+    <item><p>Select the document or collection.</p></item>
+    <item><p>Right-click to see the <gui>Properties</gui>.</p></item>
   </steps>
 
 </page>
diff --git a/gnome-help/C/documents-online.page b/gnome-help/C/documents-view.page
similarity index 95%
rename from gnome-help/C/documents-online.page
rename to gnome-help/C/documents-view.page
index e2709ea..0f7b938 100644
--- a/gnome-help/C/documents-online.page
+++ b/gnome-help/C/documents-view.page
@@ -1,8 +1,8 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic" style="task"
-      id="documents-online">
+      id="documents-view">
   <info>
-    <revision pkgversion="3.4.0" date="2012-02-20" status="review"/>
+    <revision pkgversion="3.5.90" date="2012-09-02" status="review"/>
 
     <link type="guide" xref="documents#view" group="#first"/>
 
diff --git a/gnome-help/C/documents-viewgrid.page b/gnome-help/C/documents-viewgrid.page
index 9098407..c70d07e 100644
--- a/gnome-help/C/documents-viewgrid.page
+++ b/gnome-help/C/documents-viewgrid.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="documents-viewgrid">
   <info>
-    <revision pkgversion="3.4.0" date="2012-02-20" status="stub"/>
+    <revision pkgversion="3.5.90" date="2012-09-02" status="review"/>
 
     <link type="guide" xref="documents#view" />
 
@@ -11,8 +11,13 @@
       <email>yrazes gmail com</email>
       <years>2012</years>
     </credit>
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+      <years>2012</years>
+    </credit>
 
-    <desc>Change the format of what documents are presented.</desc>
+    <desc>Change the way documents are displayed.</desc>
   </info>
 
   <title>View files in a list or grid</title>
@@ -28,12 +33,14 @@
     To view in <gui>List</gui> format:</p>
    <steps>
     <item>
-      <p>Go to the top bar and click on <app>Documents</app>.</p>
+      <p>Go to the top bar and click <app>Documents</app> to display the app
+      menu.</p>
     </item>
     <item>
       <p>Click <gui>List</gui> from the <gui>View as</gui> section.</p>
     </item>
   </steps>
 
-  <p>Click on <gui>Grid</gui> to get back the default format.</p>
-</page>
\ No newline at end of file
+  <p>Click <gui>Grid</gui> to return to the default format.</p>
+  
+</page>