GNOME.org
 

[gnome-user-docs] Documents edits, first installment

commit f0f2787af5800c8fd0b1b450ce1f057f66fa28fa
Author: Michael Hill <mdhill src gnome org>
Date:   Sat Sep 1 22:46:11 2012 -0400

    Documents edits, first installment

 gnome-help/C/documents-collections.page            |   44 ++++++++++---------
 ...-favorite.page => documents-favorite.page.stub} |   29 +++++++++---
 gnome-help/C/documents-formats.page                |   30 +++++++++++++
 gnome-help/C/documents-location.page               |   11 +++-
 gnome-help/C/documents-online.page                 |   15 +++++--
 gnome-help/C/documents.page                        |   46 +++++++-------------
 6 files changed, 110 insertions(+), 65 deletions(-)
---
diff --git a/gnome-help/C/documents-collections.page b/gnome-help/C/documents-collections.page
index fcaeedc..be605f4 100644
--- a/gnome-help/C/documents-collections.page
+++ b/gnome-help/C/documents-collections.page
@@ -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>Group relating documents in a collection.</desc>
+    <desc>Group related documents in a collection.</desc>
   </info>
 
   <title>Make collections of documents</title>
@@ -28,27 +33,24 @@
     </p>
   </comment>
 
-  <p><app>Documents</app> lets you put together different documents of different
-  types, in only one place called <gui>Collection</gui>.
-  If you have documents that are related, you may group them to find documents
-  easier. For example, if you have a business trip and you did a presentation
-  there, you can group documents like your flight itinerary (which is a PDF file),
-  your spreadsheet of the budget and other hybrid PDF/ODF documents, in one
-  collection.
-  </p>
-
-  <p>You may think that you can put collections inside collections, but
-  the behavior of collections are not the same of the behavior of folders and
-  their hierarchy. So,<em> you cannot put collections inside collections. </em>
-  </p>
-
-  <p>You can search collections
-  by:</p>
+  <p><app>Documents</app> lets you put together documents of different types in
+  one place called a <em>collection</em>. If you have documents that are
+  related, you can group them to make them easier to find. For example, if you
+  had a business trip where you made a presentation, your flight itinerary
+  (a PDF file), your spreadsheet of the budget and other hybrid PDF/ODF
+  documents, can be grouped in one collection.</p>
+
+  <note>
+   <p>Collections do not behave the same as folders and their hierarchy: <em>you
+   cannot put collections inside collections.</em></p>
+  </note>
+
+  <p>To search your collections:</p>
   <list>
-   <item><p>Pressing <keyseq><key>Ctrl</key><key>F</key></keyseq> or
-    <keyseq><key>Ctrl</key><key>S</key></keyseq>.</p></item>
-   <item><p>Typing the name of the collection.</p></item>
-   <item><p>Clicking on the magnifying glass icon, and select the filters related
+   <item><p>Press <keyseq><key>Ctrl</key><key>F</key></keyseq> or
+   <keyseq><key>Ctrl</key><key>S</key></keyseq>, and type the name of the
+   collection.</p></item>
+   <item><p>Click on the magnifying glass icon and select the filters related
    to the collection you are looking for. You can add a word to be more specific
    in the searching.</p></item>
   </list>
diff --git a/gnome-help/C/documents-favorite.page b/gnome-help/C/documents-favorite.page.stub
similarity index 60%
rename from gnome-help/C/documents-favorite.page
rename to gnome-help/C/documents-favorite.page.stub
index 627ef81..5b73d0a 100644
--- a/gnome-help/C/documents-favorite.page
+++ b/gnome-help/C/documents-favorite.page.stub
@@ -9,11 +9,16 @@
       <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>Mark your favorite documents and collections.</desc>
   </info>
 
-  <title>See only your favorite documents</title>
+  <title>View only your favorite documents</title>
 
   <comment>
     <cite date="2012-02-29" href="mailto:yrazes gmail com">Julita Inca</cite>
@@ -23,10 +28,19 @@
        - How to mark a document as a favorite.</p>
   </comment>
 
-  <p>From all the documents or collections you have, you may use some of them
-   frequently, or you may need to reach some others as quick as possible because
-   you work with them regularly. You can identify these documents easily, if you
-   mark them as favorites.</p>
+  <p>You may use some of your documents or collections more frequently than
+  others. These can be accessed quickly if you mark them as favorites.</p>
+
+  <p>To mark documents or collections as favorites:</p>
+
+  <steps>
+    <item><p>Click the <gui>Check</gui> button.</p></item>
+    <item><p>Select the document or documents you want to mark as favorites.</p>
+    </item>
+    <item><p>Click the <gui>Heart</gui> button from the bottom menu.</p>
+    </item>
+  </steps>
+
   <p>To display documents or collections marked as favorites:</p>
 
   <steps>
@@ -37,7 +51,8 @@
     </item>
   </steps>
 
-  <note style="tip"><p>To unmark favorite documents or collections, click on the
+  <note style="tip">
+    <p>To unmark favorite documents or collections, click on the
     document or collection and click the heart button from the bottom menu.</p>
   </note>
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/documents-formats.page b/gnome-help/C/documents-formats.page
new file mode 100644
index 0000000..99ea412
--- /dev/null
+++ b/gnome-help/C/documents-formats.page
@@ -0,0 +1,30 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="documents-formats">
+  <info>
+    <revision pkgversion="3.5.90" date="2012-08-31" status="review"/>
+
+    <credit type="author copyright">
+      <name>Michael Hill</name>
+      <email>mdhill src gnome org</email>
+      <years>2012</years>
+    </credit>
+
+    <link type="guide" xref="documents#view" group="#first"/>
+
+    <desc><app>Documents</app> displays a number of popular document types.</desc>
+  </info>
+
+  <title>Formats supported</title>
+
+  <comment>
+    <cite date="2012-08-31" href="mailto:mdhill src gnome org">Michael Hill</cite>
+    <p>This assumes the reader knows how to.... By the end of this page,
+    the reader will be able to....</p>
+  </comment>
+
+  <p><app>Documents</app> supports PDF, DVI, XPS, PostScript and the formats
+   supported by <app>Evince</app>, <app>Microsoft Office</app>,
+   <app>LibreOffice</app> and <app>Google Docs</app>.</p>
+
+</page>
diff --git a/gnome-help/C/documents-location.page b/gnome-help/C/documents-location.page
index e44453c..ab99ef5 100644
--- a/gnome-help/C/documents-location.page
+++ b/gnome-help/C/documents-location.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="documents-location">
   <info>
-    <revision pkgversion="3.4.0" date="2012-02-20" status="stub"/>
+    <revision pkgversion="3.5.90" date="2012-09-01" 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>Find out which location a document is stored in.</desc>
+    <desc>Find out where a document is stored.</desc>
   </info>
 
   <title>Find where a document is stored</title>
@@ -37,4 +42,4 @@
       <gui>Properties</gui> of the document or collection.</p></item>
   </steps>
 
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/documents-online.page b/gnome-help/C/documents-online.page
index 1e44411..e2709ea 100644
--- a/gnome-help/C/documents-online.page
+++ b/gnome-help/C/documents-online.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="documents-online">
   <info>
-    <revision pkgversion="3.4.0" date="2012-02-20" status="stub"/>
+    <revision pkgversion="3.4.0" date="2012-02-20" status="review"/>
 
     <link type="guide" xref="documents#view" group="#first"/>
 
@@ -11,11 +11,16 @@
       <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>Full screen view for documents.</desc>
+    <desc>View documents full-screen.</desc>
   </info>
 
-  <title>View documents stored/ shared online</title>
+  <title>Display documents stored locally or online</title>
 
   <comment>
     <cite date="2012-02-20" href="mailto:yrazes gmail com">Julita Inca</cite>
@@ -34,6 +39,8 @@
     <link xref="accounts-add">online account</link>.</p>
   <p>To view documents stored/ shared locally or remote/GoogleDocs:</p>
 
+  <p>With <app>Documents</app>, you can read your documents full screen,
+  without the distracting of tools or menus other applications have.</p>
 
   <steps>
     <item><p>Click the <em>Check</em> button located in the right side.</p></item>
@@ -41,4 +48,4 @@
   <note style="tip"><p>Documents are ready for you to review, edit,
     <link xref="printing">print</link> or
     <link xref="documents-collection-send">share.</link></p></note>
-</page>
\ No newline at end of file
+</page>
diff --git a/gnome-help/C/documents.page b/gnome-help/C/documents.page
index 9163732..5f32442 100644
--- a/gnome-help/C/documents.page
+++ b/gnome-help/C/documents.page
@@ -2,7 +2,7 @@
       type="guide" style="task"
       id="documents">
   <info>
-    <revision pkgversion="3.4.0" date="2012-02-20" status="stub"/>
+    <revision pkgversion="3.5.90" date="2012-08-31" status="review"/>
 
     <!-- <link type="guide" xref="XXX" /> -->
 
@@ -11,46 +11,32 @@
       <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>Organize all the documents you stored locally on your computer and
-     all the documents you created online.</desc>
+    <desc>Organize the documents stored locally on your computer or created
+     online.</desc>
   </info>
 
   <title>Documents</title>
 
   <comment>
     <cite date="2012-02-20" href="mailto:yrazes gmail com">Julita Inca</cite>
-    <p>This assumes the reader knows how to use <em>GoogleDocs</em>. By the end of this page,
-    the reader will be able to organize all your documents in one application.
-    This document is about:
+    <p>This assumes the reader knows how to use <em>Google Docs</em>. By the end
+    of this page, the reader will be able to organize all your documents in one
+    application. This document is about:
        - Overview of GNOME Documents, and what it does
        - Explain that it's not really the same as a file browser
        - Explain that it can connect to remote documents</p>
   </comment>
 
-  <p><app>Documents</app> is an application of <em>GNOME</em> that lets you
-   read, store and organize information about the documents you have created.
-   Supported formats are PDF, DVI, XPS, PostScript and all the formats supported
-   by Evince, Microsoft Office, Libreoffice files and Google Docs.</p>
-
-  <p>All the documents you have in your computer locally will be automatically       	
-   presented when you open <app>Documents</app>, as well documents you have been
-   worked remotely by using <em>Google Docs</em>. This is possible if you have
-   configured an <link xref="accounts">online account</link> before.</p>
-
-  <p>  You can manage documents using <app>file browser</app> as well as pictures,
-  videos or music; but <app>Documents</app> can do more than
-  <link xref="printing">printing</link>,
-  <link xref="documents-collection-send">sharing</link>,
-  <link xref="documents-search">searching</link>,
-  <link xref="documents-sort">sorting</link>,
-  <link xref="documents-favorite">setting favorites</link>.
-  With <app>Documents</app>, you can read your documents full screen,
-  without the distracting of tools or menus other applications have.  It also
-  provides you reminders of the documents you have to read,
-  <link xref="documents-collections">make collections</link> and
-  <link xref="documents-location">identify</link> your documents so quickly
-  through the previous thumbnail.</p>
+  <p><app>Documents</app> is a GNOME application that lets you display,
+   organize, print and share the documents you have created. The documents on
+   your computer or those created remotely using <em>Google Docs</em> will be
+   displayed as thumbnails, and will open full-screen with a single click.</p>
 
  <section id="view" style="2column">
     <title>Views and Find</title>
@@ -71,4 +57,4 @@
  <section id="question" style="2column">
     <title>Questions</title>
  </section>
-</page>
\ No newline at end of file
+</page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]