diff -r 000000000000 -r 6474c204b198 services/docs/datareporting.rst
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/services/docs/datareporting.rst	Wed Dec 31 06:09:35 2014 +0100
@@ -0,0 +1,28 @@
+.. _data_reporting_service:
+
+======================
+Data Reporting Service
+======================
+
+``/services/datareporting`` contains files related to an XPCOM service
+that collects and reports data within Gecko applications.
+
+The important files in this directory are:
+
+DataReportingService.js
+   An XPCOM service that coordinates collection and reporting of data.
+
+policy.jsm
+   A module containing the logic for coordinating and driving collection
+   and upload of data.
+
+sessions.jsm
+   Records Gecko application session history. This is loaded as part of
+   the XPCOM service because it needs to capture state from very early in
+   the application lifecycle. Bug 841561 tracks implementing this in C++.
+
+There is other code in the tree that collects and uploads data. The
+original intent of this directory and XPCOM service was to serve as a
+focal point for the coordination of all this activity so that it could
+all be done consistently and properly. This vision may or may not be fully
+realized.