From 4eb738320c2a3e62867b16d44604672ed664cb3a Mon Sep 17 00:00:00 2001
From: Ekaterina Gerasimova <kittykat3756@gmail.com>
Date: Tue, 2 Jul 2013 23:18:49 +0100
Subject: Add help for cookie pref and data

---
 help/C/cookies.xml       | 35 ++++++++++++++++++++++++++++
 help/C/data-cookies.page | 35 ++++++++++++++--------------
 help/C/pref-cookies.page | 60 ++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 113 insertions(+), 17 deletions(-)
 create mode 100644 help/C/cookies.xml
 create mode 100644 help/C/pref-cookies.page

(limited to 'help/C')

diff --git a/help/C/cookies.xml b/help/C/cookies.xml
new file mode 100644
index 000000000..e1bd44006
--- /dev/null
+++ b/help/C/cookies.xml
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      xmlns:its="http://www.w3.org/2005/11/its"
+      type="topic" style="task"
+      id="cookies">
+
+  <info>
+    <link type="guide" xref="index#privacy"/>
+    <link type="guide" xref="data"/>
+    <revision pkgversion="3.10" date="2013-07-02" status="review"/>
+
+    <credit type="author copyright">
+      <name>Ekaterine Gerasimova</name>
+      <email its:translate="no">kittykat3756@gmail.com</email>
+      <years>2013</years>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>What are cookies?</title>
+
+  <comment>
+    <cite date="2013-07-02">Kat</cite>
+    <p>I am assuming that our average reader will not know what a cookie is, so
+    this is included in both data-cookies and pref-cookies.</p>
+  </comment>
+
+  <p>A browser <em>cookie</em> is a small piece of data sent from a website and
+  stored on your computer while you are browsing a website. When the you
+  return to the same website in the future, the data stored in the cookie can
+  be retrieved by the website to notify the website of your previous activity.
+  Cookies are a common method used by web servers to know whether you are
+  logged in to an account on a specific website or not.</p>
+
+</page>
diff --git a/help/C/data-cookies.page b/help/C/data-cookies.page
index 27d7b00d8..34b88a00f 100644
--- a/help/C/data-cookies.page
+++ b/help/C/data-cookies.page
@@ -5,46 +5,47 @@
 
   <info>
     <link type="guide" xref="index#privacy"/>
-    <link type="guide" xref="bookmark"/>
-    <revision pkgversion="3.9" version="0.1" date="2013-04-12" status="stub"/>
+    <link type="guide" xref="data"/>
+    <revision pkgversion="3.10" date="2013-07-02" status="review"/>
 
     <credit type="author copyright">
       <name>Ekaterine Gerasimova</name>
       <email its:translate="no">kittykat3756@gmail.com</email>
       <years>2013</years>
     </credit>
-    <credit type="copyright editor">
+<!--    <credit type="copyright editor">
       <name></name>
       <email its:translate="no"></email>
       <years></years>
-    </credit>
+    </credit>-->
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>What are cookies?</desc>
+    <desc>How do I delete a cookie if I don't want a website to track me anymore?</desc>
   </info>
 
-  <title>What are cookies?</title>
+  <title>Delete a cookie</title>
 
-  <p>A browser cookie is a small piece of data sent from a website and stored
-  in <app>Web</app> while you are browsing a website. When the you return to
-  the same website in the future, the data stored in the cookie can be
-  retrieved by the website to notify the website of your previous activity.
-  Cookies are a common method used by web servers to know whether you are
-  logged in to an account on a specific website or not.</p>
+  <!-- Include an explanation about cookies. -->
+  <include href="cookies.xml" xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:p)" xmlns="http://www.w3.org/2001/XInclude"/>
 
-  <!-- What can the user do with in the "Cookies" tab? -->
-  <p></p>
+  <p>If you no longer want a specific website to track you, you can check if it
+  left a cookie and delete it.</p>
 
   <steps>
     <item>
-      <p></p>
+      <p>Open <guiseq><gui style="menu">Web</gui><gui style="menuitem">Personal
+      Data</gui><gui style="tab">Cookies</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Select the cookies that you want to delete.</p>
     </item>
     <item>
-      <p></p>
+      <p>Press <gui style="button">Remove</gui>.</p>
     </item>
   </steps>
 
-  <p></p>
+  <p>You can also delete all of your cookies using the
+  <gui style="button">Clear</gui> button.</p>
 
 </page>
diff --git a/help/C/pref-cookies.page b/help/C/pref-cookies.page
new file mode 100644
index 000000000..bdf2287e3
--- /dev/null
+++ b/help/C/pref-cookies.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      xmlns:its="http://www.w3.org/2005/11/its"
+      type="topic" style="task"
+      id="pref-cookies">
+
+  <info>
+    <link type="guide" xref="index#privacy"/>
+    <link type="guide" xref="pref"/>
+    <revision pkgversion="3.10" date="2013-07-02" status="review"/>
+
+    <credit type="author copyright">
+      <name>Ekaterine Gerasimova</name>
+      <email its:translate="no">kittykat3756@gmail.com</email>
+      <years>2013</years>
+    </credit>
+<!--    <credit type="copyright editor">
+      <name></name>
+      <email its:translate="no"></email>
+      <years></years>
+    </credit>-->
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Chose which websites to accept cookies from.</desc>
+  </info>
+
+  <title>Set cookie preference</title>
+
+  <!-- Include an explanation about cookies. -->
+  <include href="cookies.xml" xpointer="xmlns(mal=http://projectmallard.org/1.0/)xpointer(/mal:page/mal:p)" xmlns="http://www.w3.org/2001/XInclude"/>
+
+  <p>You can specify whether you want to accept cookies and from which
+  websites.</p>
+
+  <steps>
+    <item>
+      <p>Open
+      <guiseq><gui style="menu">Web</gui><gui style="menuitem">Preferences</gui><gui style="tab">Privacy</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Select whether you want to accept cookies from all websites, only from
+      websites which you have visited or to not accept any cookies.</p>
+    </item>
+  </steps>
+
+  <p>You should normally use <gui>Only from sites you visit</gui> because this
+  option allows you to log into your accounts on most websites while preventing
+  websites that you have not visited from leaving cookies.</p>
+
+  <p>If you chose to accept cookies from <gui>All websites</gui>, then websites
+  that you have not visited will be able to leave <em>third party cookies</em>.
+  Third party cookies are often used by advertisers and social media websites
+  to track your activity across websites and offer targeted content. Note that
+  some websites, such as Outlook.com, use third party cookies to monitor
+  whether you are logged in.</p>
+
+  <p>If you <gui>Never accept</gui> cookies, you may have trouble logging into
+  your accounts on some websites.</p>
+
+</page>
-- 
cgit v1.2.3