Issues addressed

Author: delapuente

README.md

@@ -76,9 +76,9 @@ Reach out to us with any questions you may have or help you may need, and partic
 
 ## Developer Privacy Notice for Data Collection
 
-To help improve the WebVR API and the WebVR Export assets, Mozilla automatically receives technical, interaction, and error data of end users, using [Sentry](https://sentry.io) and [Google Analytics](https://analytics.google.com/analytics/web/). For example, this includes number of times VR device is mounted and worn; number of times VR mode is enabled and time spent; time for webpages to load and time open; and a unique browser identifier.
+To help improve the WebVR API and the [Unity WebVR assets](https://assetstore.unity.com/packages/templates/systems/webvr-assets-109152), Mozilla automatically receives [general-usage statistics](./TELEMETRY.md#list-of-collected-data) and error exceptions of end users, using [Sentry](https://sentry.io) and [Google Analytics](https://analytics.google.com/analytics/web/).
 
-Developers can turn off this data collection by [modifying the configuration snippet that comes with the VR template](./docs/customization/disabling-telemetry.md).  
+Developers can turn off this data collection by [modifying the configuration snippet that comes with the VR template](./docs/customization/disabling-telemetry.md).
 
 End users can turn off this data collection by enabling [`Do-Not-Track`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/DNT) in their browsers.
 
@@ -88,7 +88,6 @@ This project was heavily influenced by early explorations in using Unity to buil
 
 Also, thanks to [@arturitu](https://github.com/arturitu) for creating the [3D-hand models](https://github.com/aframevr/assets/tree/gh-pages/controllers/hands) used for controllers in these examples.
 
-
 ## License
 
 Copyright 2017 - 2018 Mozilla Corporation

TELEMETRY.md

@@ -0,0 +1,44 @@
+# Developer Privacy Notice for Data Collection
+
+To help improve the WebVR API and the [Unity WebVR assets](https://assetstore.unity.com/packages/templates/systems/webvr-assets-109152), Mozilla automatically receives general-usage statistics and error exceptions of end users, using [Sentry](https://sentry.io) and [Google Analytics](https://analytics.google.com/analytics/web/).
+
+Developers can turn off this data collection by [modifying the configuration snippet that comes with the VR template](./docs/customization/disabling-telemetry.md).
+
+End users can turn off this data collection by enabling [`Do-Not-Track`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/DNT) in their browsers.
+
+## List of Collected Data
+
+- Unique UUID-v4 random identifier (generated according to [IETF RFC4122](http://www.ietf.org/rfc/rfc4122.txt)), persisted in the browser's [`LocalStorage`](https://developer.mozilla.org/en-US/docs/Web/API/Storage/LocalStorage)
+- JavaScript error (exception) messages (without file paths)
+- Console messages (i.e., error, warning, log, info)
+- Respects [Do-Not-Track](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/DNT) (i.e., `DNT: 1` HTTP header and `navigator.doNotTrack === '1'` JavaScript value)
+- Dimensions (width × height) of the browser's `screen` and `window`, ratio of the resolution (i.e., `navigator.devicePixelRatio`)
+- Release version of the [Unity WebVR Assets](https://github.com/mozilla/unity-webvr-export) package being used (e.g., [`v1.0.1`](https://github.com/mozilla/unity-webvr-export/releases/tag/v1.0.1))
+- JavaScript Heap memory used (measured in megabytes)
+- [WebXR API](https://immersive-web.github.io/webxr/spec/latest/) support (i.e., `navigator.xr`)
+- [WebVR v1.1 API](https://immersive-web.github.io/webvr/spec/1.1/) support (i.e., `navigator.getVRDisplays`)
+- [WebVR v1.1 events](https://immersive-web.github.io/webvr/spec/1.1/#interface-window) emitted by the browser (i.e., user-initiated actions and headset events) during a unique page load:
+    - Number of times and time until VR mode is entered (e.g., user keypress, user click, automatically presented)
+    - Number of times and time until VR mode is exiting (e.g., user keypress, user click, automatically exited, browser's Back button, browser's navigation to another page, etc.)
+    - Number of times and time until a VR device is worn/mounted
+    - Number of times and time until a VR device is taken off/unmounted
+    - Number of times and time until a VR device has been connected (or detected on page load)
+    - Number of times and time until a VR device has been disconnected/unplugged
+    - Number of times and time until a mouse cursor is temporarily disabled for input while "pointerlocked" in VR mode (e.g., for Windows Mixed Reality's desktop flat-pane views)
+    - Number of times and time until a mouse cursor is temporarily disabled for input while "pointerlocked" in VR mode (e.g., for Windows Mixed Reality's desktop flat-pane views)
+- Amount of time the active page took to load and to reach:
+    - Loading screen
+    - Splash screen
+    - Unity game
+- Amount of time the active page was open for ("session length")
+- Browser's `User-Agent` string (i.e., `navigator.userAgent`)
+- [WebGL 1.0 API](https://www.khronos.org/registry/webgl/specs/latest/1.0/) support
+- [WebGL 2.0 API](https://www.khronos.org/registry/webgl/specs/latest/2.0/) support
+- [Gamepad API](https://w3c.github.io/gamepad/)
+    - Support of API (i.e., `navigator.getGamepads`)
+    - Names of connected gamepads (i.e., `Gamepad#id`)
+- [Web Audio API](https://webaudio.github.io/web-audio-api/) support (i.e., `AudioContext`)
+- [WebAssembly (WASM) API](http://webassembly.org) support (i.e., `WebAssembly`)
+- [Web Worker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) support (i.e., `Worker`)
+- [Service Worker API](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) (i.e., `navigator.serviceWorker`)
+- [`requestIdleCallback` API](https://developer.mozilla.org/en-US/docs/Web/API/Window/requestIdleCallback) (i.e., `window.requestIdleCallback`)

docs/customization/adding-ga.md

@@ -2,7 +2,7 @@
 
 Google Analytics is a popular web analytics service that tracks and reports website traffic. It offers insight about your user behaviour and allows you to make informed decisions regarding the evolution of your site.
 
-The [VR template](../../Assets/WebGLTemplates/WebVR/index.html) that comes with the [Unity package](https://u3d.as/1476) already includes Analytics as a part of the telemetry library used for [collecting usage data](../data-collection.md) but you'll need to set up a Google Analytics account and get a [tracking Id](https://support.google.com/analytics/answer/7372977) first, before using it.
+The [VR template](../../Assets/WebGLTemplates/WebVR/index.html) that comes with the [Unity package](https://u3d.as/1476) already includes Analytics as a part of the telemetry library used for [collecting usage data](../data-collection.md) but you'll need to set up a Google Analytics account and get a [Tracking ID](https://support.google.com/analytics/answer/7372977) first, before using it.
 
 ## Quick set up
 
@@ -42,7 +42,7 @@ ga('create', 'UA-XXXXXX-Y', 'auto');
 ga('send', 'pageview');
 ```
 
-When using Analytics inside the template, use the `create` method of `MozillaReasearch.telemetry.ga` instead of the `create` command. It will return a tracking function which can be used in the same way you would use it in the guide [Sending Data to Google Analytics.](https://developers.google.com/analytics/devguides/collection/analyticsjs/creating-trackers) 
+When using Analytics inside the template, use the `create` method of `MozillaReasearch.telemetry.ga` instead of the `create` command. It will return a tracking function which can be used in the same way you would use it in the guide [Sending Data to Google Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/creating-trackers).
 
 ```js
 var ga = MozillaResearch.telemetry.ga.create('UA-XXXXXX-Y', 'auto');

docs/customization/disabling-telemetry.md

@@ -1,6 +1,6 @@
-# Disabling telemetry
+# Disabling Telemetry
 
-The code enabling telemetry data collection is in the VR template that comes with the package. Ensure you've already added [the package from the store](https://u3d.as/1476) to your Unity project and look for the following snippet inside the [`index.html` file](../../Assets/WebGLTemplates/WebVR/index.html) of the template:
+The code that enables Mozilla-Research Telemetry collection is in the VR template that comes with the package. Ensure you've already added [the package from the store](https://u3d.as/1476) to your Unity project and look for the following snippet inside the [`index.html` file](../../Assets/WebGLTemplates/WebVR/index.html) of the template:
 
 ```js
 MozillaResearch.telemetry.start({
@@ -10,9 +10,9 @@ MozillaResearch.telemetry.start({
 });
 ```
 
-By default, collecting number of visits, error logs and some performance measurements is enabled by setting the proper options (`analytics`, `errorLogging` and `performance` respectively) to `true`.
+By default, each, number of visits, error logs and some performance measurements are enabled by setting the proper option (`analytics`, `errorLogging` and `performance` respectively) to `true`.
 
-To prevent the template from sending such information, set the corresponding options to `false`:
+To prevent the template from sending such information, set the appropiate options to `false`:
 
 ```js
 MozillaResearch.telemetry.start({
@@ -22,7 +22,7 @@ MozillaResearch.telemetry.start({
 });
 ```
 
-Or remove/comment the line completely:
+Or by commenting out these lines, or removing the code completely from the `index.html` file:
 
 ```js
 /*MozillaResearch.telemetry.start({