GNOME.org
 

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

commit 6ea7e70a3ab794ddd6e80bd19e570ea1a4854ec6
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
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/{createanalbum.page => create-album.page}   |    0
 help/C/{deleteanalbum.page => delete-album.page}   |    0
 .../{removephotos.page => delete-from-album.page}  |    0
 help/C/favorites-set.page                          |   51 +++++++++++++
 help/C/favorites.page                              |   29 ++++++++
 help/C/index.page                                  |   76 +++++++++-----------
 help/C/legal.xml                                   |    8 ++
 help/C/{printing.page => print.page}               |    0
 help/C/{imgprops.page => properties.page}          |    0
 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                                   |    9 ++-
 16 files changed, 242 insertions(+), 232 deletions(-)
---
diff --git a/help/C/createanalbum.page b/help/C/create-album.page
similarity index 100%
rename from help/C/createanalbum.page
rename to help/C/create-album.page
diff --git a/help/C/deleteanalbum.page b/help/C/delete-album.page
similarity index 100%
rename from help/C/deleteanalbum.page
rename to help/C/delete-album.page
diff --git a/help/C/removephotos.page b/help/C/delete-from-album.page
similarity index 100%
rename from help/C/removephotos.page
rename to help/C/delete-from-album.page
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..284eb63 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -1,47 +1,41 @@
 <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>
+    <revision pkgversion="3.8" date="2014-03-25" status="review"/>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <title type="text">Photos</title>
+
+    <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"></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>
+
+   <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/printing.page b/help/C/print.page
similarity index 100%
rename from help/C/printing.page
rename to help/C/print.page
diff --git a/help/C/imgprops.page b/help/C/properties.page
similarity index 100%
rename from help/C/imgprops.page
rename to help/C/properties.page
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..c11a4e6 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -2,7 +2,14 @@
 
 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 =
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]