Add a human readable explanation of the privacy policy

.circleci/lando.yml

@@ -1,3 +1,3 @@
 stats:
   - report: false
-    url: https://metrics.devwithlando.io
+    url: https://metrics.lando.dev

PRIVACY.md

@@ -1,6 +1,7 @@
 # Privacy Policy
 
 Effective date: November 26, 2019
+
 Kalabox Inc DBA Tandem ("Tandem", "us", "we", or "our") operates the Lando software (hereinafter referred to as the "Software").
 
 This page informs you of our policies regarding the collection, use and disclosure of personal data when you use our Software and the choices you have associated with that data.
@@ -9,7 +10,7 @@ The Software automatically communicates with Tandem to send error reports and co
 
 We use your data to provide and improve the Software. By using the Software, you agree to the collection and use of information in accordance with this policy. Unless otherwise defined in this Privacy Policy, the terms used in this Privacy Policy have the same meanings as in our Terms and Conditions, accessible at https://raw.githubusercontent.com/lando/lando/master/TERMS.md
 
-For a more human readable version of this, check out: https://docs.lando.dev/help/data.html
+For a more human readable explanation of this, check out: https://docs.lando.dev/help/data.html
 
 ## Definitions
 
@@ -59,7 +60,7 @@ You may opt out of sending the usage data and error reports by following instruc
 
 #### Crash Data
 
-Crash Data will only be sent to Tandem if the user opts in and gives us permission to do so. We have tried our best to anonymize Crash Data, but recognize that some path names and other information that we collect may inadvertently include Personal Data, including but not limited to usernames and site names.
+Crash Data will only be sent to Tandem if the user opts in and gives us permission to do so. We have tried our best to pseudonymize Crash Data, but recognize that some path names and other information that we collect may inadvertently include Personal Data, including but not limited to usernames and site names.
 
 View a Lando log file to see a sample of what we collect.
 https://docs.lando.dev/help/data.html
@@ -142,7 +143,7 @@ You have the right to complain to a Data Protection Authority about our collecti
 
 ## Software Providers
 
-Tandem utilizes services from Bugsnag Inc. and Qbox, Inc. to store and process data from the Software and has obtained Data Protection Agreements with both entities for this purpose.
+Tandem utilizes services from Bugsnag Inc. and Qbox, Inc. to store and process data from the Software and has obtained DPAs with both entities for this purpose.
 
 These third parties have access to your Personal Data only to perform these tasks on our behalf and are obligated not to disclose or use it for any other purpose.
 

TERMS.md

@@ -77,9 +77,7 @@ PLEASE READ THIS AGREEMENT CAREFULLY. BY CLICKING “I ACCEPT,” OR BY INSTALLI
 
 ## Privacy Notices
 
-The Software automatically communicates with to send error reports and collect usage data so we may improve the Software. You may opt out of sending the usage data and error reports by following instructions provided in relevant Software documentation.
-
-We have tried our best to anonymize usage data, but recognize that some path names and other information that we collect may inadvertently include personally identifiable information, including but not limited to usernames and sitenames. View a Lando log file to see a sample of what we collect.
+See PRIVACY.md
 
 ## Disclaimers and Limitations on Liability
 

docs/.vuepress/config.js

@@ -238,6 +238,13 @@ module.exports = {
             ['https://github.com/lando/lando/tree/master/examples', 'Code examples'],
           ],
         },
+        {
+          title: 'Data',
+          collapsable: false,
+          children: [
+            ['data', 'Privacy Policy for Humans'],
+          ],
+        },
         {
           title: 'Project Updates',
           collapsable: false,

docs/help/data.md

@@ -0,0 +1,91 @@
+---
+description: Learn how to handle file syncing issue when using Lando for local development.
+---
+
+# Privacy Policy for Humans
+
+Because most sane people are not lawyers we've included this more-human-accessible explanation of Lando's [Privacy Policy](https://github.com/lando/lando/blob/master/PRIVACY.md). Note that this *_is not_* the actual Privacy Policy.
+
+## tl;dr
+
+Lando collects two kinds of information for the sole purpose of improving Lando: _Usage Data_ and _Crash Data_.
+
+We store and process this data in [QBOX](https://qbox.io/). Additionally, we store Crash Data in [Bugsnag](https://www.bugsnag.com/). Lando does not share, sell or transmit your data to any other parties. We have obtained DPAs with both QBOX and Bugsnag for this purpose.
+
+### Usage Data
+
+Usage Data is pseudonymized and automatically collected by default during common Lando runtime events such starting, stopping or destroying an application. Here is an example of usage data collected during a `lando rebuild`.
+
+```json
+{
+  "context": "local",
+  "devMode": false,
+  "instance": "fc8bdd13-03bc-4642-b064-b2eda1c64398",
+  "nodeVersion": "v10.4.1",
+  "mode": "cli",
+  "os": {
+    "type": "Linux",
+    "platform": "linux",
+    "release": "5.3.8-300.fc31.x86_64",
+    "arch": "x64"
+  },
+  "product": "lando",
+  "version": "3.0.0-rc.22",
+  "app": "6424b9c225b9f1b7cd46deffec8599d17d8f3f4e",
+  "type": "drupal8",
+  "services": [
+    "php:7.2",
+    "mysql",
+    "mailhog"
+  ],
+  "action": "rebuild",
+  "created": "2019-11-26T15:15:52.733Z"
+}
+```
+
+Each Lando instance is uniquely identifiable by an ID which is stored at `~/.lando/cache/id`. This corresponds to the `instance` property above. While we store this data the only way we can tie specific data to a given Lando user is if the user themselves tells us which instance id belongs to them.
+
+We will also pseudonymize your app's name.
+
+If you would like to see what data is sent you can run either examine the [Lando logs](./logs.md), or run a Lando command with debug verbosity.
+
+```bash
+lando start -vvv
+
+# debug: Logging metrics data"command":"lando start","context":"local","devMode":false,"instance":"bdb5354f0597b5b465e86db8255c2b6e1e742f70","nodeVersion":"v10.15.0","mode":"cli","os":{"type":"Darwin","platform":"darwin","release":"19.0.0","arch":"x64"},"product":"lando","version":"3.0.0-rc.22","app":"8e8533752bafe1499af4352e923b4d2e82396927","type":"none","services":["node:10","node:10","node:10","php:7.3"],"action":"start","created":"2019-11-26T15:24:16.468Z"} to [{"report":true,"url":"https://metrics.lando.dev"}]
+```
+
+If you would like to opt-out you can do so by adding the following to your [Lando global config](./../config/global.md)
+
+```yaml
+stats:
+  - report: false
+    url: https://metrics.lando.dev
+```
+
+## Crash Data
+
+Crash Data will only be sent to Tandem if the user opts in and gives us permission to do so. The user will be prompted the first time Lando detects an error.
+
+```bash
+lando start
+
+Lando has crashed!!!
+
+Would you like to report it, and subsequent errors, to Lando?
+
+This data is only used by the Lando team to ensure the application runs as well as it can.
+For more details check out https://docs.lando.dev/privacy/
+
+? Send crash reports? (Y/n)
+```
+
+Crash Data will include the same information as Usage Data with the addition of the error message and its stack trace.
+
+We try our best to sanitize these additional properties but recognize that path names and other information that we collect may inadvertently include personal data including but not limited to usernames and site names.
+
+If you would like to reset your error reporting preference so that Lando prompts you again on the next error you can run this command.
+
+```bash
+rm ~/.lando/cache/report_errors
+```