[gnome-photos] help: review user help, bug 711505



commit a7818961ba539ae8a680d5058140925c5cf48410
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Thu Apr 3 21:35:35 2014 +0100

    help: review user help, bug 711505
    
    Add index.page - Index
    Add the legal.xml file - CC-by-SA 3.0 Unported license
    Add the guide page to view photos
    ->Sub pages
        - view photos from an album
        - view favourites.
    
    Also add changes after Kat's review, so link the view-favorites page to
    the favorites page.

 help/C/addphotos.page       |   60 --------------------------------
 help/C/favorites-set.page   |   51 +++++++++++++++++++++++++++
 help/C/favorites.page       |   29 +++++++++++++++
 help/C/index.page           |   80 +++++++++++++++++++-----------------------
 help/C/legal.xml            |    8 ++++
 help/C/setupfavourites.page |   55 -----------------------------
 help/C/view-album.page      |   40 +++++++++++++++++++++
 help/C/view-favorites.page  |   40 +++++++++++++++++++++
 help/C/view.page            |   31 ++++++++++++++++
 help/C/viewingphoto.page    |   75 ----------------------------------------
 help/Makefile.am            |   12 +++++-
 11 files changed, 245 insertions(+), 236 deletions(-)
---
diff --git a/help/C/favorites-set.page b/help/C/favorites-set.page
new file mode 100644
index 0000000..f2411ee
--- /dev/null
+++ b/help/C/favorites-set.page
@@ -0,0 +1,51 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="favorites-set">
+
+  <info>
+    <link type="guide" xref="favorites"/>
+
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Pick favorites from <app>Photos</app>.</desc>
+  </info>
+
+  <title>Tag your favorites</title>
+
+  <p>Photos or albums can be marked as favorites from the
+  <gui style="tab">Recent</gui> tab or <gui style="tab">Albums</gui> tab.</p>
+
+  <steps>
+  <title>To label favorite items:</title>
+    <item>
+      <p>Select the <gui>Albums</gui> tab or <gui>Recent</gui> tab depending on
+      whether you want to mark an album or a photo as a favorite.</p>
+    </item>
+    <item>
+      <p><link xref="selection-mode-toggle#on">Switch on</link> the selection
+      mode.</p>
+    </item>
+    <item>
+      <p><link xref="selection-mode-how">Select</link> all the items you want
+      to favorite.</p>
+    </item>
+    <item>
+      <p>To finish, select the button with the picture of a heart from the
+      toolbar at the bottom.</p>
+    </item>
+  </steps>
+
+  <p>Your favorite items can now be found in the <gui>Favorites</gui> tab.</p>
+
+</page>
diff --git a/help/C/favorites.page b/help/C/favorites.page
new file mode 100644
index 0000000..9f2b4cd
--- /dev/null
+++ b/help/C/favorites.page
@@ -0,0 +1,29 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="guide" style="task"
+       id="favorites">
+
+  <info>
+    <link type="guide" xref="index"/>
+
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Tag a special image or album as a favorite.</desc>
+
+  </info>
+
+  <title>Favorite photos</title>
+    <p>You can label photos or images that you particularly like as favorites to
+    store them for easy access in the <gui>Favorites</gui> tab.</p>
+
+</page>
diff --git a/help/C/index.page b/help/C/index.page
index c661be1..4b2520b 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -1,47 +1,39 @@
 <page xmlns="http://projectmallard.org/1.0/";
-       type="guide" style="2column"
-       id="index">
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="guide" style="2column"
+      id="index">
 
- <info>
-  <title type="link">Photos</title>
-  <credit type="author">
-   <name>Venkatesh Tahiliani</name>
-   <email>pulsar viki gmail com</email>
-  </credit>
-  <credit type="editor">
-   <name>Aruna Sankaranarayanan</name>
-   <email>safincrazy gmail com</email>
-  </credit>
-   <license>
-   <p>
-     Creative Commons Share Alike 3.0
-   </p>
-  </license>
- </info>
-   <title>
-     <media type="image" src="media/logo1.png" width="28" height="28"></media>
-      Photos
-   </title>
-     <p>
-        <app> Photos</app> is an application a user can use as an alternative
-        to the file browser. It also enables a user to directly view photos
-        present in the picture directory in a much more interactive way and
-        perform tasks like creating albums, printing photos and setting
-        favourites.
-     </p>
-   <section id="gettingstarted" style="2column">
-     <title>
-       Getting started
-     </title>
-   </section>
-   <section id="albums" style="2column">
-      <title>
-        Albums
-      </title>
-   </section>
-   <section id="preferences" style="2column">
-      <title>
-        Preferences
-      </title>
-   </section>
+  <info>
+    <title type="text">Photos</title>
+    <revision pkgversion="3.8" date="2014-03-25" status="review"/>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc><app>Photos</app> is a personalised photo manager tool from
+    GNOME.</desc>
+  </info>
+
+  <title>
+    <media its:translate="no" type="image" src="media/logo1.png" height="32" />
+    Photos
+  </title>
+
+  <p><app>Photos</app> can be used to organise and manage your images in an
+  engaging and personalized manner. In addition to creating albums out of
+  images on your computer, you can integrate your Facebook and Flickr albums
+  with <app>Photos</app>. You can also set photos you like as your desktop
+  wallpaper, or easily bookmark them as favorites.</p>
+
+<!--
+  <section id="gettingstarted" style="2column">
+    <title>Getting started</title>
+  </section>
+
+  <section id="albums" style="2column">
+    <title>Albums</title>
+  </section>
+  <section id="preferences" style="2column">
+    <title>Preferences</title>
+  </section>
+-->
 </page>
diff --git a/help/C/legal.xml b/help/C/legal.xml
new file mode 100644
index 0000000..aa36246
--- /dev/null
+++ b/help/C/legal.xml
@@ -0,0 +1,8 @@
+<license xmlns="http://projectmallard.org/1.0/";
+         href="http://creativecommons.org/licenses/by-sa/3.0/";>
+
+  <p>This work is licensed under a
+  <link href="http://creativecommons.org/licenses/by-sa/3.0/";>Creative Commons
+  Attribution-ShareAlike 3.0 Unported License</link>.</p>
+
+</license>
diff --git a/help/C/view-album.page b/help/C/view-album.page
new file mode 100644
index 0000000..8510956
--- /dev/null
+++ b/help/C/view-album.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="view-album">
+
+  <info>
+    <link type="guide" xref="view"/>
+
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Open a photo from your albums.</desc>
+  </info>
+
+  <title>View photos from an album</title>
+  <p>To open a photo located in a specific album:</p>
+
+  <steps>
+    <item>
+      <p>Select the <gui style="tab">Albums</gui> tab.</p>
+    </item>
+    <item>
+      <p>Select the album which contains the photo.</p>
+    </item>
+    <item>
+      <p>You will see a grid of photos from the album you selected. Select a
+      photo from the grid to open it. </p>
+    </item>
+  </steps>
+
+</page>
diff --git a/help/C/view-favorites.page b/help/C/view-favorites.page
new file mode 100644
index 0000000..351db8e
--- /dev/null
+++ b/help/C/view-favorites.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="view-favorites">
+
+  <info>
+    <link type="guide" xref="view"/>
+    <link type="seealso" xref="favorites"/>
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Open your favorite photos.</desc>
+  </info>
+
+  <title>View photos marked as favorites.</title>
+
+  <p>Your <link xref="favorites">favorite</link> photos are located in the
+  <gui>Favorites</gui> tab.</p>
+
+  <steps>
+  <title>To open a photo tagged as a favorite:</title>
+    <item>
+      <p>Select the <gui style="tab">Favorites</gui> tab.</p>
+    </item>
+    <item>
+      <p>Select photo you want to open, or use the arrow keys to navigate to
+      the photo and press <key>Enter</key>.</p>
+    </item>
+  </steps>
+
+</page>
diff --git a/help/C/view.page b/help/C/view.page
new file mode 100644
index 0000000..f8f37f0
--- /dev/null
+++ b/help/C/view.page
@@ -0,0 +1,31 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="guide" style="task"
+       id="view">
+
+  <info>
+    <link type="guide" xref="index"/>
+
+    <revision pkgversion="3.12" date="2014-03-13" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Venkatesh Tahiliani</name>
+      <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Open a photo for viewing.</desc>
+  </info>
+
+  <title>View images</title>
+
+  <p>When <app>Photos</app> is opened, you will see the <gui>Recent</gui> tab
+  open. The <gui>Recent</gui> tab contains images from your computer, the
+  <gui>Albums</gui> tab contains your photo albums, and any image you mark as a
+  favourite can be found in the <gui>Favorites</gui> tab.</p>
+
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index 859332d..4aa4b26 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -2,8 +2,16 @@
 
 HELP_ID = gnome-photos
 
-HELP_FILES = 
+HELP_FILES = \
+        favorites.page \
+        favorites-set.page \
+        index.page \
+        legal.xml \
+        view-album.page \
+        view-favorites.page \
+        view.page
 
-HELP_MEDIA =
+HELP_MEDIA = \
+       media/icon1.png
 
 HELP_LINGUAS =


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]