[california/wip/732302-help] docs: Draft of Quick Add page complete. Updated status of index.



commit 3da2fe75f7e1e182c6629a5ffba65c3d7b5f19ad
Author: Jim Campbell <jcampbell gnome org>
Date:   Thu Sep 11 23:01:20 2014 -0500

    docs: Draft of Quick Add page complete. Updated status of index.
    
    I've completed an initial, working draft of the
    cal-event-quick-add.page document. It should be serviceable for
    the 0.2 release, but I've marked it as 'review' for now. I'd
    like for others to take a look at it.
    
    Also updated the status of the index page.

 help/C/cal-event-quick-add.page |   59 +++++++++++++++++++++++++++++++-------
 help/C/index.page               |    2 +-
 2 files changed, 49 insertions(+), 12 deletions(-)
---
diff --git a/help/C/cal-event-quick-add.page b/help/C/cal-event-quick-add.page
index ccb6cb7..6cd2a82 100644
--- a/help/C/cal-event-quick-add.page
+++ b/help/C/cal-event-quick-add.page
@@ -1,13 +1,14 @@
 <page xmlns="http://projectmallard.org/1.0/";
       xmlns:its="http://www.w3.org/2005/11/its";
+      xmlns:ui="http://projectmallard.org/ui/1.0/";
       type="guide" style="task" version="1.0 ui/1.0"
       id="cal-event-quick-add">
 
   <info>
-    <desc>Use the Quick Add feature to add calendar events.</desc>
+    <desc>Add an event to your calendar using everyday language.</desc>
     <link type="guide" xref="index#cal-manage-events"/>
     <link type="seealso" xref="cal-event-edit"/>
-    <revision pkgversion="0.2" date="2014-09-11" status="inconplete"/>
+    <revision pkgversion="0.2" date="2014-09-11" status="review"/>
 
     <credit type="author copyright">
       <name>Jim Campbell</name>
@@ -18,20 +19,56 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Add an Event to Your Calendar</title>
+  <title>Use the Quick Add Feature to Add Events</title>
   
   <p>One of the best features of <app>California</app> is how it allows you to
   add events to your calendar using everyday language. In <app>California</app>
   this is called the <em>Quick Add</em> feature.</p>
+
+  <p>The best way to see how the <em>Quick Add</em> feature works is to look at
+  a few examples.</p>
+
+  <section id="quick-add-event">
+    <title>Create Both One-Time and Recurring Events</title> 
   
-  <p>To add an event using the <em>Quick Add</em> feature, you need to supply
-  three pieces of information:</p>
-    <list>
-      <item><p><em>What</em> the event is.</p></item>
-      <item><p>The <em>day</em> the event will occur.</p></item>
-      <item><p>The <em>time</em> the event will start.</p></item>
-    </list>
+  <p>We can use the <em>Quick Add</em> feature to add events that occur only
+  one time and events that occur more than once:</p>
   
-  <p>Let's look at a few examples:</p>
+  <steps>
+    <item><p>Start by Pressing the <gui>Plus</gui> button in the upper-right
+    portion of <app>California's</app> <gui>menu bar</gui>, or by pressing
+    <keyseq><key>Ctrl</key><key>N</key></keyseq>.</p>
+    <p>The <em>Quick Add</em> window will appear.</p></item>
+    
+    <item><p>Enter the details of your event. You can describe the event using
+    natural language:</p>
+    <list ui:expanded="false">
+      <title>Examples of one-time events</title>
+      <item><p><em>Meet James at the movies on Saturday at 11:00am.</em></p>
+      </item>
+      <item><p><em>Go to Jeff and Mindy's wedding. October 26th at 4:00pm</em>
+      </p></item>
+      <item><p><em>Meet Petr, Jana and Florian at Al Capone's Pizza on Saturday
+      at 7:00pm</em></p></item>
+    </list>
+
+    <list ui:expanded="false">
+      <title>Examples of recurring events</title>
+      <item><p><em>Take out the trash every Tuesday at 7:30am</em></p></item>
+      <item><p><em>Swimming class every Tuesday and Thursday at 6:00pm</em></p>
+      </item>
+      <item><p><em>Mom's birthday every year on April 16th</em></p></item>
+    </list>
+    </item>
+    
+    <item><p>After you have entered your event details, press
+    <gui>Create</gui>. <app>California</app> will use the information that you
+    have entered to create the event on your calendar.</p></item>
+  </steps>
 
+  <note style="tip"><p>By default, the <em>Quick Add</em> feature will create
+  events that last for one hour. You may wish to adjust the duration of your
+  events. See the <link href="cal-event-edit">Edit an Existing Event</link>
+  page for more information about editing events.</p></note>
+  </section>
 </page>
diff --git a/help/C/index.page b/help/C/index.page
index aa36233..0508095 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -9,7 +9,7 @@
     <title type="link">California</title>
     <title type="text">California</title>
 
-    <revision pkgversion="0.2" date="2014-07-05" status="incomplete"/>
+    <revision pkgversion="0.2" date="2014-09-06" status="candidate"/>
     <credit type="author copyright">
       <name>Jim Campbell</name>
       <email its:translate="no">jcampbell gnome org</email>


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