[gnome-user-docs] accounts: Updates for 3.18, info on specific services to come

From: Shaun McCance <shaunm src gnome org>
To: commits-list gnome org
Cc:
Subject: [gnome-user-docs] accounts: Updates for 3.18, info on specific services to come
Date: Mon, 28 Sep 2015 18:16:55 +0000 (UTC)
commit 50931f898882021b7c614b377e3b32ace46ef461
Author: Shaun McCance <shaunm redhat com>
Date:   Mon Sep 28 14:16:11 2015 -0400

    accounts: Updates for 3.18, info on specific services to come

 gnome-help/C/accounts-add.page                    |   36 ++++++----
 gnome-help/C/accounts-create.page                 |   77 ---------------------
 gnome-help/C/accounts-disable-service.page        |   17 +++--
 gnome-help/C/accounts-provider-not-available.page |    6 +-
 gnome-help/C/accounts-remove.page                 |   35 +++++++---
 gnome-help/C/accounts-which-application.page      |    4 +
 gnome-help/C/accounts-whyadd.page                 |   16 +++--
 gnome-help/C/accounts.page                        |   17 +++--
 gnome-help/Makefile.am                            |    1 -
 9 files changed, 81 insertions(+), 128 deletions(-)
---
diff --git a/gnome-help/C/accounts-add.page b/gnome-help/C/accounts-add.page
index 39a0814..6f242f0 100644
--- a/gnome-help/C/accounts-add.page
+++ b/gnome-help/C/accounts-add.page
@@ -1,30 +1,36 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:its="http://www.w3.org/2005/11/its";
       type="topic" style="task"
       id="accounts-add">
 
   <info>
-    <link type="guide" xref="accounts"/>
+    <link type="guide" xref="accounts" group="add"/>
 
     <revision pkgversion="3.5.5" date="2012-08-14" status="draft"/>
     <revision pkgversion="3.9.92" date="2012-09-18" status="candidate"/>
     <revision pkgversion="3.13.92" date="2013-09-20" status="candidate"/>
+    <revision pkgversion="3.18" date="2015-09-28" status="candidate"/>
 
     <credit type="author">
       <name>Jim Campbell</name>
-      <email its:translate="no">jwcampbell gmail com</email>
+      <email>jwcampbell gmail com</email>
     </credit>
     <credit type="editor">
       <name>Michael Hill</name>
-      <email its:translate="no">mdhillca gmail com</email>
+      <email>mdhillca gmail com</email>
     </credit>
     <credit type="editor">
       <name>Ekaterina Gerasimova</name>
-      <email its:translate="no">kittykat3756 gmail com</email>
+      <email>kittykat3756 gmail com</email>
       <years>2014</years>
     </credit>
+    <credit type="editor">
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
+      <years>2015</years>
+    </credit>
 
-    <desc>Connect to an online account.</desc>
+    <desc>Allow applications to access your accounts online for photos,
+    contacts, calendars, and more.</desc>
 </info>
 
   <title>Add an account</title>
@@ -47,13 +53,12 @@
     </item>
     <item>
       <p>Select the type of account which you want to add.</p>
-      <p>If you want to add more than one account type, you can do so at a
-      later time.</p>
     </item>
     <item>
       <p>A small website window or dialog will open where you can enter your
       online account credentials. For example, if you are setting up a Google
-      account, enter your Google username and password.</p>
+      account, enter your Google username and password. Some providers allow
+      you to create a new account from the login dialog.</p>
     </item>
     <item>
       <p>If you have entered your credentials correctly, you will be prompted
@@ -67,14 +72,15 @@
     </item>
   </steps>
 
-  <p>After you have added the accounts, each application that you have selected
-  will automatically use those credentials when you start them.</p>
+  <p>After you have added accounts, applications can use those accounts for
+  the services you have chosen to allow. See <link xref="accounts-disable-service"/>
+  for information on controlling which services to allow.</p>
 
   <note style="tip">
-    <p>For security reasons, GNOME will not store your password on your
-    computer. Instead, it stores a token that is provided by the online
-    service. If you want to fully revoke the link between your desktop and the
-    online service, <link xref="accounts-remove">remove</link> it.</p>
+    <p>Many online services provide an authorization token which GNOME stores
+    instead of your password. If you remove an account, you should also revoke
+    that certificate in the online service. See <link xref="accounts-remove"/>
+    for more information.</p>
   </note>
 
 </page>
diff --git a/gnome-help/C/accounts-disable-service.page b/gnome-help/C/accounts-disable-service.page
index 3ca66c4..3fed4fa 100644
--- a/gnome-help/C/accounts-disable-service.page
+++ b/gnome-help/C/accounts-disable-service.page
@@ -1,5 +1,4 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:its="http://www.w3.org/2005/11/its";
       type="topic" style="task"
       id="accounts-disable-service">
 
@@ -8,10 +7,11 @@
 
     <revision pkgversion="3.5.5" date="2012-08-14" status="review"/>
     <revision pkgversion="3.13.92" date="2013-09-20" status="candidate"/>
+    <revision pkgversion="3.18" date="2015-09-28" status="final"/>
 
     <credit type="author">
       <name>Phil Bull</name>
-      <email its:translate="no">philbull gmail com</email>
+      <email>philbull gmail com</email>
     </credit>
     
     <desc>Some online accounts can be used to access multiple services (like
@@ -21,11 +21,11 @@
 
   <title>Control which online services an account can be used to access</title>
 
-  <p>Some types of online account allow you to access several services with the
-  same user account. For example, Google accounts provide access to calendar,
-  email, contacts and chat. You may want to use your account for some services,
-  but not others. For example, you may want to use your Google account for
-  email but not chat, since you have a different online account that you use
+  <p>Some types of online account providers allow you to access several services
+  with the same user account. For example, Google accounts provide access to
+  calendar, email, contacts and chat. You may want to use your account for some
+  services, but not others. For example, you may want to use your Google account
+  for email but not chat if you have a different online account that you use
   for chat.</p>
 
   <p>You can disable some of the services that are provided by each online
@@ -45,7 +45,8 @@
     </item>
     <item>
       <p>A list of services that are available with this account will be
-      shown under <gui>Use for</gui>.</p>
+      shown under <gui>Use for</gui>. See <link xref="accounts-which-application"/>
+      to see which applications access which services.</p>
     </item>
     <item>
       <p>Switch off any of the services that you do not want to use.</p>
diff --git a/gnome-help/C/accounts-provider-not-available.page 
b/gnome-help/C/accounts-provider-not-available.page
index 5158784..8d32cdd 100644
--- a/gnome-help/C/accounts-provider-not-available.page
+++ b/gnome-help/C/accounts-provider-not-available.page
@@ -1,5 +1,4 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:its="http://www.w3.org/2005/11/its";
       type="topic" style="question"
       id="accounts-provider-not-available">
 
@@ -8,14 +7,15 @@
 
     <revision pkgversion="3.5.5" date="2012-08-14" status="review"/>
     <revision pkgversion="3.9.92" date="2013-09-18" status="review"/>
+    <revision pkgversion="3.18" date="2015-09-28" status="final"/>
 
     <credit type="author">
       <name>Baptiste Mille-Mathias</name>
-      <email its:translate="no">baptistem gnome org</email>
+      <email>baptistem gnome org</email>
     </credit>
     <credit type="editor">
       <name>Michael Hill</name>
-      <email its:translate="no">mdhillca gmail com</email>
+      <email>mdhillca gmail com</email>
     </credit>
 
     <desc>What if an online service provider is not listed?</desc>
diff --git a/gnome-help/C/accounts-remove.page b/gnome-help/C/accounts-remove.page
index 7d475e3..4f2aacd 100644
--- a/gnome-help/C/accounts-remove.page
+++ b/gnome-help/C/accounts-remove.page
@@ -1,32 +1,50 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:its="http://www.w3.org/2005/11/its";
       type="topic" style="task"
       id="accounts-remove">
 
   <info>
-    <link type="guide" xref="accounts"/>
+    <link type="guide" xref="accounts" group="remove"/>
     <link type="seealso" xref="accounts-disable-service"/>
 
     <revision pkgversion="3.5.5" date="2012-08-15" status="draft"/>
     <revision pkgversion="3.9.92" date="2013-09-18" status="draft"/>
     <revision pkgversion="3.13.92" date="2014-09-20" status="candidate"/>
+    <revision pkgversion="3.18" date="2015-09-28" status="candidate"/>
 
     <credit type="author">
       <name>Michael Hill</name>
-      <email its:translate="no">mdhillca gmail com</email>
+      <email>mdhillca gmail com</email>
     </credit>
     <credit type="editor">
       <name>Ekaterina Gerasimova</name>
-      <email its:translate="no">kittykat3756 gmail com</email>
+      <email>kittykat3756 gmail com</email>
+    </credit>
+    <credit type="editor">
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
+      <years>2015</years>
     </credit>
 
-    <desc>Delete an online account.</desc>
+    <desc>Remove access to an online service provider from your
+    applications.</desc>
   </info>
 
-<title>Remove an account</title>
+  <title>Remove an account</title>
 
   <p>You can remove an online account which you no longer wish to use.</p>
 
+  <note style="tip">
+    <p>Many online services provide an authorization token which GNOME stores
+    instead of your password. If you remove an account, you should also revoke
+    that certificate in the online service. This will ensure that no other
+    application or website can connect to that service using the authorization
+    for GNOME.</p>
+
+    <p>How to revoke the authorization depends on the service provider. Check
+    your settings on the provider's website for authorized or connected apps
+    or sites. Look for an app called "GNOME" and remove it.</p>
+  </note>
+
   <steps>
     <item>
       <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
@@ -43,7 +61,7 @@
       window.</p>
     </item>
     <item>
-      <p>Click <gui>Remove</gui>.</p>
+      <p>Click <gui>Remove</gui> in the confirmation dialog.</p>
     </item>
   </steps>
 
@@ -52,7 +70,4 @@
     <link xref="accounts-disable-service">restrict the services</link> accessed
     by your desktop.</p>
   </note>
-
-  <p>To prevent GNOME from accessing the online account, you should revoke the
-  access through the account's website or similar service.</p>
 </page>
diff --git a/gnome-help/C/accounts-which-application.page b/gnome-help/C/accounts-which-application.page
index 7028b9d..f20684a 100644
--- a/gnome-help/C/accounts-which-application.page
+++ b/gnome-help/C/accounts-which-application.page
@@ -9,6 +9,7 @@
 
     <revision pkgversion="3.8.2" date="2013-05-22" status="review"/>
     <revision pkgversion="3.13.92" date="2014-09-20" status="review"/>
+    <revision pkgversion="3.18" date="2015-09-28" status="outdated"/>
 
     <credit type="author copyright">
       <name>Baptiste Mille-Mathias</name>
@@ -29,7 +30,10 @@
 
   </info>
 
+<!--
 <title>Which applications take advantage of online accounts?</title>
+-->
+<title>Online services and applications</title>
 
   <p><app>Online Accounts</app> can be used by external applications to
   automatically configure themselves.</p>
diff --git a/gnome-help/C/accounts-whyadd.page b/gnome-help/C/accounts-whyadd.page
index c990be8..08f239b 100644
--- a/gnome-help/C/accounts-whyadd.page
+++ b/gnome-help/C/accounts-whyadd.page
@@ -1,40 +1,42 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:its="http://www.w3.org/2005/11/its";
       type="topic" style="question"
       id="accounts-whyadd">
 
   <info>
-    <link type="guide" xref="accounts"/>
+    <link type="guide" xref="accounts" group="#first"/>
 
     <revision pkgversion="3.5.5" date="2012-08-14" status="review"/>
     <revision pkgversion="3.13.92" date="2014-02-20" status="candidate"/>
+    <revision pkgversion="3.18" date="2015-09-28" status="final"/>
 
     <credit type="author copyright">
       <name>Susanna Huhtanen</name>
-      <email its:translate="no">ihmis suski gmail com</email>
+      <email>ihmis suski gmail com</email>
       <years>2012</years>
     </credit>
     <credit type="editor">
       <name>Michael Hill</name>
-      <email its:translate="no">mdhillca gmail com</email>
+      <email>mdhillca gmail com</email>
     </credit>
     <credit type="editor">
       <name>Ekaterina Gerasimova</name>
-      <email its:translate="no">kittykat3756 gmail com</email>
+      <email>kittykat3756 gmail com</email>
       <years>2014</years>
     </credit>
 
     <desc>Why add your email or social media accounts to your desktop?</desc>
   </info>
 
-<title>Why should I add an account?</title>
+  <title>Why add an account?</title>
 
   <p>Adding your online accounts brings your choice of services like calendar,
-  chat and e-mail straight to your desktop and makes the information of the
+  chat, and e-mail straight to your desktop and makes the information of the
   services a seamless part of your user experience. By adding accounts you can
   easily keep in touch using services from different accounts, like chats, at
   the same time. Just set up your online accounts once and every time you start
   your computer all the accounts and services that you have added are ready to
   use.</p>
 
+  <p>See <link xref="accounts-which-application"/> for information on which
+  applications can access which online services.</p>
 </page>
diff --git a/gnome-help/C/accounts.page b/gnome-help/C/accounts.page
index 28e01d4..3e1fd27 100644
--- a/gnome-help/C/accounts.page
+++ b/gnome-help/C/accounts.page
@@ -7,6 +7,7 @@
     <link type="guide" xref="prefs"/>
 
     <revision pkgversion="3.5.5" version="0.1" date="2012-08-14" status="review"/>
+    <revision pkgversion="3.18" date="2015-09-28" status="final"/>
 
     <credit type="author">
       <name>Phil Bull</name>
@@ -14,17 +15,19 @@
     </credit>
 
     <desc>
-      <link xref="accounts-create">Create a new account</link>,
-      <link xref="accounts-add">Add an existing account</link>,
-      <link xref="accounts-remove">Remove an account</link>…
+      <link xref="accounts-add">Add an online account</link>,
+      <link xref="accounts-remove">Remove an account</link>,
+      <link xref="accounts-which-application">Learn about services</link>…
     </desc>
   </info>
 
   <title>Online accounts</title>
 
-  <p>You can enter your login details for some online services (such as Google
-  and Facebook) into the <app>Online Accounts</app> window. This will let you
-  easily access your calendar, mail, chat accounts, and similar, from those
-  applications without having to enter your account details again.</p>
+  <p>You can enter your login details for some online services, such as Google
+  and Facebook, into the <app>Online Accounts</app> window. This lets you use
+  applications to access online services like email, calendars, chat, and
+  documents.</p>
+
+  <links type="topic" groups="add remove #first #default #last"/>
 
 </page>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 3f15143..f54f2df 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -123,7 +123,6 @@ HELP_FILES = \
        a11y-visualalert.page \
        about-this-guide.page \
        accounts-add.page \
-       accounts-create.page \
        accounts-disable-service.page \
        accounts-provider-not-available.page \
        accounts-remove.page \
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]