[tor-commits] [privacy-docs/master] Some updates to docs

[hiro at torproject.org]

commit b67e2415ec80b2a4305c10e04fba5a945039fa95
Author: hiro <hiro at torproject.org>
Date:   Thu Mar 28 15:51:22 2019 +0100

    Some updates to docs
---
 dev-guides/browser-api.md       |  1 +
 dev-guides/css.md               |  7 +++++++
 dev-guides/media-formats.md     |  1 +
 dev-guides/tor-browser.md       | 12 +++++++++++-
 patterns/data-confinement.md    |  2 +-
 patterns/data-store.md          |  2 ++
 patterns/metadata.md            |  2 ++
 patterns/tracking-protection.md |  6 +-----
 references.md                   |  2 ++
 9 files changed, 28 insertions(+), 7 deletions(-)

diff --git a/dev-guides/browser-api.md b/dev-guides/browser-api.md
index e69de29..3eeb19a 100644
--- a/dev-guides/browser-api.md
+++ b/dev-guides/browser-api.md
@@ -0,0 +1 @@
+## Interact with the browser ##
diff --git a/dev-guides/css.md b/dev-guides/css.md
index e69de29..8fe34d7 100644
--- a/dev-guides/css.md
+++ b/dev-guides/css.md
@@ -0,0 +1,7 @@
+## CSS ##
+
+## How can CSS be used to interact with the DOM ##
+
+## When can CSS be used _instead_ of JavaScript ##
+
+## Security concerns regarding user interactions tracking and CSS ##
diff --git a/dev-guides/media-formats.md b/dev-guides/media-formats.md
index e69de29..257132d 100644
--- a/dev-guides/media-formats.md
+++ b/dev-guides/media-formats.md
@@ -0,0 +1 @@
+## What are media formats ##
diff --git a/dev-guides/tor-browser.md b/dev-guides/tor-browser.md
index 6af6624..31ba78c 100644
--- a/dev-guides/tor-browser.md
+++ b/dev-guides/tor-browser.md
@@ -1 +1,11 @@
-# Developing with Tor browser design in mind #
+## Designing a browser for privacy ##
+
+The Tor Browser is designed to allow 
+
+The Tor Browser Design Requirements are meant to describe the properties of a Private Browsing Mode that defends against both network and local forensic adversaries.
+
+There are two main categories of requirements: Security Requirements, and Privacy Requirements. Security Requirements are the minimum properties in order for a browser to be able to support Tor and similar privacy proxies safely. Privacy requirements are the set of properties that cause us to prefer one browser over another.
+
+
+
+The Tor Browser is based on [https://www.mozilla.org/en-US/firefox/organizations/](Mozilla's Extended Support Release - ESR -  Firefox branch)
diff --git a/patterns/data-confinement.md b/patterns/data-confinement.md
index 670eede..9f712c3 100644
--- a/patterns/data-confinement.md
+++ b/patterns/data-confinement.md
@@ -21,4 +21,4 @@ Some amount of data processing and storing can be instead transferred to the use
 
 ## Secondary effects ##
 
-Reduce leaking personal information in case of a breach
+Reduce leaking personal information in case of a breach.
diff --git a/patterns/data-store.md b/patterns/data-store.md
index b4bade4..e0729e8 100644
--- a/patterns/data-store.md
+++ b/patterns/data-store.md
@@ -20,3 +20,5 @@ When stored by third parties data subjects lose control over their documents. Fu
 ## Use case ##
 
 ## Secondary effects ##
+
+Reduce leaking of personal information. Create distributed services. Create applications without having to invest heavily on user storage.
diff --git a/patterns/metadata.md b/patterns/metadata.md
index 9aeb527..eb86301 100644
--- a/patterns/metadata.md
+++ b/patterns/metadata.md
@@ -27,3 +27,5 @@ Metadata are often invisible to users, yet these are automatically attached to t
 ## Use case ##
 
 ## Secondary effects ##
+
+Avoid leaking of personal information. Protect sensible users and vulnerable group by don't storing potentially user identifying data.
diff --git a/patterns/tracking-protection.md b/patterns/tracking-protection.md
index 45938b3..65710d6 100644
--- a/patterns/tracking-protection.md
+++ b/patterns/tracking-protection.md
@@ -27,8 +27,4 @@ There are also some more advanced fingerprinting techniques trying to capture us
 
 ## Secondary effects ##
 
-websites load faster
-
-reduce memory leaks
-
-reduce battery consumption
+Websites load faster. Reduce memory leaks. Reduce battery consumption of mobile devices.
diff --git a/references.md b/references.md
index a08076b..b4045d0 100644
--- a/references.md
+++ b/references.md
@@ -7,3 +7,5 @@ https://s3-eu-west-1.amazonaws.com/projectsbyif.com/data-ethics-practices/9+prac
 https://catalogue.projectsbyif.com/
 
 https://timkadlec.com/remembers/2019-01-09-the-ethics-of-performance/
+
+https://www.torproject.org/projects/torbrowser/design/