GNOME.org
 

[gnome-user-docs] Some Contacts updates

commit f75f035accbda6dc69f9969f9bec8845aaf80228
Author: Michael Hill <mdhillca gmail com>
Date:   Mon Aug 13 18:36:31 2012 -0400

    Some Contacts updates

 gnome-help/C/contacts-add-remove-contact.page      |   34 ---------
 gnome-help/C/contacts-add-remove.page              |   48 +++++++++++++
 gnome-help/C/contacts-edit-details.page            |   29 ++++++---
 gnome-help/C/contacts-import.page                  |   72 ++++++++++++++++++++
 ...-unlink.page => contacts-link-unlink.page.stub} |   14 +++-
 gnome-help/C/contacts-search.page                  |   17 ++++-
 gnome-help/C/contacts-setup.page                   |   35 ++++++++++
 gnome-help/C/contacts.page                         |   26 +++++++
 gnome-help/Makefile.am                             |    3 +
 9 files changed, 227 insertions(+), 51 deletions(-)
---
diff --git a/gnome-help/C/contacts-add-remove.page b/gnome-help/C/contacts-add-remove.page
new file mode 100644
index 0000000..735cb2a
--- /dev/null
+++ b/gnome-help/C/contacts-add-remove.page
@@ -0,0 +1,48 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="contacts-add-remove">
+
+  <info>
+
+    <link type="guide" xref="contacts"/>
+
+    <revision pkgversion="3.5.5" date="2012-08-13" status="review"/>
+    <credit type="author">
+      <name>Lucie Hankey</name>
+      <email>ldhankey gmail com</email>
+    </credit>
+
+    <credit type="author">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Add or remove a contact in the local address book.</desc>
+
+  </info>
+
+<title>Add or remove a contact</title>
+
+<p>To add a contact:</p>
+
+<steps>
+  <item><p>Click <gui style="button">New</gui>.</p></item>
+  <item><p>In the <gui>New contact</gui> window, enter the contact name and the
+   desired information. Click on the menu next to each field to choose
+   <gui>Work</gui>, <gui>Home</gui>, <gui>Other</gui>, or <gui>Custom...</gui>
+   <gui>Custom</gui> allows you to in your own category.</p></item>
+  <item><p>Click <gui style="button">Create Contact</gui>.</p></item>
+</steps>
+
+<p>To remove a contact:</p>
+
+<steps>
+  <item><p>Click <gui style="button">New</gui>.</p></item>
+  <item><p>Right-click the contact name in the right pane and select
+   <gui>Delete</gui> .</p></item>
+  <item><p>Click <gui style="button">X</gui> to confirm.</p></item>
+</steps>
+
+</page>
diff --git a/gnome-help/C/contacts-edit-details.page b/gnome-help/C/contacts-edit-details.page
index 37d33da..164c5aa 100644
--- a/gnome-help/C/contacts-edit-details.page
+++ b/gnome-help/C/contacts-edit-details.page
@@ -3,37 +3,48 @@
       id="contacts-edit-details">
 
   <info>
-    <desc></desc>
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <desc>Edit the information for each contact.</desc>
+
+    <link type="guide" xref="contacts"/>
+
+    <revision pkgversion="3.5.5" date="2012-08-13" status="review"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
     </credit>
 
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
+
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
 <title>Edit contact details</title>
 
-  <p>Editing contact details helps you keep the information in your address book up to date and complete.</p>
+  <p>Editing contact details helps you keep the information in your address book
+   up to date and complete.</p>
 
   <steps>
    <item><p>
     Select the contact you wish to edit in the left pane.
    </p></item>
    <item><p>
-    Click on <gui>Edit</gui> in the right pane. You can now edit the contact's nickname.
-   </p></item>
-   <item><p>
-     You can also add, edit or delete the e-mail address, phone number, postal address or link information.
+    In the right pane, click on the contact's avatar or any text information
+    to change.
    </p></item>
    <item><p>
-    When you are finished, click <gui>Back to Contact</gui>
+    To add information that isn't shown, or an additional phone number or
+    e-mail address, click <gui style="button">Add detail...</gui> Select a
+    field from the list and click <gui style="button">OK</gui>, and fill in the
+    information.
    </p></item>
   </steps>
 
 <note>
-  <p>In the case of linked contacts, you can edit the different profiles by clicking on the profiles avatars.</p>
+  <p>In the case of linked contacts, you can edit a profile by clicking on the
+   profile's avatar.</p>
 </note>
 
 <comment>
diff --git a/gnome-help/C/contacts-import.page b/gnome-help/C/contacts-import.page
new file mode 100644
index 0000000..b212e10
--- /dev/null
+++ b/gnome-help/C/contacts-import.page
@@ -0,0 +1,72 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="contacts-import">
+
+  <info>
+
+    <link type="guide" xref="contacts"/>
+
+    <revision pkgversion="3.5.5" date="2012-08-13" status="review"/>
+
+    <credit type="author">
+      <name>Lucie Hankey</name>
+      <email>ldhankey gmail com</email>
+    </credit>
+
+    <credit type="author copyright">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+      <years>2012</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Choose between Local Address Book or Online Account.</desc>
+
+  </info>
+
+<title>Import contacts</title>
+
+<steps>
+  <item><p>To open <gui>Contacts</gui>, click on <gui>Activities</gui> in the
+   top left corner of the screen. Click on <gui>Applications</gui> and select
+   <gui>Contacts</gui> from the menu that appears. The <gui>Contacts</gui>
+   window will open up.</p></item>
+  <item><p>To add (or remove) a single contact manually, click on the
+   <gui style="button">+</gui> (or <gui style="button">-</gui>) button and
+   follow the prompts.</p></item>
+  <item><p>To import (or remove) contacts from an online account, click on the
+   <gui style="button">Online Accounts</gui> button. The <gui>Online Accounts</gui>
+   window will open. Click on <gui style="button">+</gui> to add an account, or
+   <gui>-</gui> to remove an account. Select the account type that you wish to
+   add (or remove).</p></item>
+  <item><p>Your account provider may ask for your permission for a third party
+   user to access your account and ask you to sign in to your account. You may
+   be informed what information the GNOME application wishes to access. Allow
+   GNOME to access your account.</p></item>
+  <item><p>You may now be asked to unlock your keyring, if it is not already
+   unlocked. When you have done this a window will appear telling you that an
+   online account needs your attention. Open the online account and login. Your
+   account will appear in the left hand panel of the <gui>Online Accounts</gui>
+   window, and the right hand panel will allow you to control what you want to
+   use the account for.</p></item>
+  <item><p>Close the <gui>Online Accounts</gui> window. If your contacts don't
+   appear in the <gui>Contacts</gui> window, close it and reopen it. The
+   contacts from your online account will appear in the left hand panel of the
+   window. Click on a contact to bring up its details in the right hand window,
+   where you will be able to edit, delete, or add a note to the contact. See
+   also <link xref="contacts-edit-details">Editing contacts</link>. To send an
+   email to the contact, click on the envelope that appears by the email
+   address.</p></item>
+
+</steps>
+
+<note>
+  <p>To import contacts from another address book applicaton, follow these
+   steps: create a free online account such as Gmail, Hotmail, Yahoo etc. Export
+   your address book from the application and import it into your online account
+   following the provider's instructions. Import your online account into
+   <gui>GNOME Contacts</gui>. You will then have all your contacts available.</p>
+</note>
+
+</page>
diff --git a/gnome-help/C/contacts-link-unlink.page b/gnome-help/C/contacts-link-unlink.page.stub
similarity index 84%
rename from gnome-help/C/contacts-link-unlink.page
rename to gnome-help/C/contacts-link-unlink.page.stub
index 5918d1b..5a35586 100644
--- a/gnome-help/C/contacts-link-unlink.page
+++ b/gnome-help/C/contacts-link-unlink.page.stub
@@ -3,6 +3,9 @@
       id="contacts-link-unlink">
 
   <info>
+
+    <link type="guide" xref="contacts"/>
+
     <desc></desc>
     <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
     <credit type="author">
@@ -18,11 +21,14 @@
 <section id="link-contacts">
 <title>Link contacts</title>
 
-  <p>Linking contacts is the combining of the same contact from multiple services into one Contacts entry.  This feature helps you keep your address book organized, with all details about one contact in one place.</p>
+  <p>Linking contacts is the combining of the same contact from multiple
+   services into one Contacts entry.  This feature helps you keep your address
+   book organized, with all details about one contact in one place.</p>
 
   <steps>
    <item><p>
-     Select the contact you wish to link by clicking on one of the entries you have for the person.
+     Select the contact you wish to link by clicking on one of the entries you
+     have for the person.
    </p></item>
    <item><p>
      Click <gui>More</gui>.
@@ -43,8 +49,8 @@
 
  <note style="tip">
   <p>
-   If you linked two contacts accidentally and want to undo the action, follow the
-   steps for unlinking contacts.
+   If you linked two contacts accidentally and want to undo the action, follow
+   the steps for unlinking contacts.
   </p>
  </note>
 </section>
diff --git a/gnome-help/C/contacts-search.page b/gnome-help/C/contacts-search.page
index ea66525..00fcb3e 100644
--- a/gnome-help/C/contacts-search.page
+++ b/gnome-help/C/contacts-search.page
@@ -3,13 +3,21 @@
       id="contacts-search">
 
   <info>
-    <desc></desc>
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <desc>Search for a contact.</desc>
+
+    <link type="guide" xref="contacts"/>
+
+    <revision pkgversion="3.5.5" date="2012-08-13" status="review"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
     </credit>
 
+    <credit type="editor">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+    </credit>
+
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
@@ -20,7 +28,7 @@
 
    <steps>
     <item><p>
-      In the <gui>Activities</gui> overview, type the contacts name.
+      In the <gui>Activities</gui> overview, type the name of the contact.
     </p></item>
     <item><p>
       The icon of the contact will appear.
@@ -30,6 +38,7 @@
     </p></item>
    </steps>
 
-  <p>You can also type the name of the contact in the search box of the <app>Contacts</app> application.</p>
+  <p>You can also type the name of the contact in the search box of
+   <app>Contacts</app>.</p>
 
 </page>
diff --git a/gnome-help/C/contacts-setup.page b/gnome-help/C/contacts-setup.page
new file mode 100644
index 0000000..e3a0a1a
--- /dev/null
+++ b/gnome-help/C/contacts-setup.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="contacts-setup">
+  <info>
+    <link type="guide" xref="contacts"/>
+
+    <revision pkgversion="3.5.5" date="2012-08-13" status="review"/>
+
+    <credit type="author copyright">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+      <years>2012</years>
+    </credit>
+
+    <desc>Store your contacts in a local address book or in an Online Account.</desc>
+  </info>
+
+  <title>Starting Contacts for the first time</title>
+
+  <comment>
+    <cite date="2012-08-13" href="mailto:mdhillca gmail com">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>When you run <app>Contacts</app> for the first time, the
+   <gui>Contacts Setup</gui> window opens. If your </p>
+
+  <steps>
+    <item><p>First step...</p></item>
+    <item><p>Second step...</p></item>
+    <item><p>Third step...</p></item>
+  </steps>
+
+</page>
diff --git a/gnome-help/C/contacts.page b/gnome-help/C/contacts.page
new file mode 100644
index 0000000..0478096
--- /dev/null
+++ b/gnome-help/C/contacts.page
@@ -0,0 +1,26 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide" style="task"
+      id="contacts">
+
+<info>
+
+  <link type="guide" xref="net"/>
+
+    <revision pkgversion="3.5.5" date="2012-08-13" status="review"/>
+
+    <credit type="author copyright">
+      <name>Michael Hill</name>
+      <email>mdhillca gmail com</email>
+      <years>2012</years>
+    </credit>
+
+  <desc>Access your contacts.</desc>
+
+</info>
+
+<title>Contacts</title>
+
+<p>Use <app>Contacts</app> to store, access or edit information for your
+ contacts, locally or in your <gui>Online Accounts</gui>.</p>
+
+</page>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 99fec46..b988f26 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -154,9 +154,12 @@ HELP_FILES = \
 	color-whatisspace.page \
 	color-why-calibrate.page \
 	color-whyimportant.page \
+  contacts-add-remove.page \
 	contacts-edit-details.page \
+	contacts-import.page \
 	contacts-link-unlink.page \
 	contacts-search.page \
+	contacts-setup.page \
 	disk-capacity.page \
 	disk-check.page \
 	disk-format.page \
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]