1 files changed, 30 insertions, 0 deletions
diff --git a/help/C/organize-rating.page b/help/C/organize-rating.page
new file mode 100644
index 0000000..e75abfa
--- /dev/null
+++ b/help/C/organize-rating.page
@@ -0,0 +1,30 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="rating">
+
+    <info>
+        <link type="guide" xref="index#organize"/>
+        <desc>Give photos a rating between 1 and 5 stars. You can reject bad photos, hiding them from view.</desc>
+        
+        <link type="next" xref="delete"/>
+    </info>
+
+	<title>Ratings</title>
+<p>You can assign each photo a rating from 1-5 stars, or may alternatively rate it as Rejected, in which case Shotwell will hide the photo by default.</p>
+
+<p>You can rate a photo or a set of photos in any of these ways:</p>
+
+<list>
+<item><p>Select the photo(s), then choose a rating from the top-level <guiseq><gui>Photos</gui><gui>Set Rating</gui></guiseq> menu.</p></item>
+<item><p>Right-click on the photo(s), then choose a rating from the Set Rating context menu.</p></item>
+<item><p>Select the photo(s), then press any of the shortcut keys <key>1</key>, <key>2</key>, <key>3</key>, <key>4</key> or <key>5</key> to assign a rating. Or press <key>9</key> to mark the photo(s) as rejected or <key>0</key> to clear the rating(s).</p></item>
+</list>
+
+<p>
+Normally Shotwell displays all photos except rejected photos. You can set a different rating filter using the <guiseq><gui>View</gui><gui>Filter Photos</gui></guiseq> menu - for example, you can display only photos rated with 3 stars or higher, or you can display all photos including those marked rejected. The Shotwell icon on the toolbar displays the current rating filter and can also be used to set the filter.</p>
+
+<p>Shotwell normally displays each photo's rating in its lower left-hand corner. You can turn off the display of ratings using the <guiseq><gui>View</gui><gui>Ratings</gui></guiseq> menu item.</p>
+
+<p>You can increase or decrease a photo's rating using the <guiseq><gui>Set Rating</gui><gui>Increase</gui></guiseq> and <guiseq><gui>Set Rating</gui><gui>Decrease</gui></guiseq> commands, or the keyboard shortcuts <key>&lt;</key> and <key>&gt;</key>. </p>
+</page>
+