Issue 1663 - Emulate background page and implement proper message responder

README.md

Index: README.md
===================================================================
--- a/README.md
+++ b/README.md
@@ -4,18 +4,24 @@ Shared Adblock Plus UI code
 The user interface elements defined in this repository will be used by various
 Adblock Plus products like Adblock Plus for Firefox. Their functionality can be
 tested within this repository, even though they might not work exactly the same
 as they will do in the final product.
 
 Directory structure
 -------------------
 
-* Top-level files: HTML pages and scripts meant to be imported into the
-  respective products.
+* Top-level files:
+  * `firstRun.html` and `firstRun.js`: First-run page, see below
+  * `i18n.js`: Localization functions, should be included by all pages.
+  * `utils.js`: Utility functions, to be removed soon.
+  * `messageResponder.js`: Script to be used on the background page to respond
+    to messages sent by UI code.
+  * `background.html`, `background.js`: Test implementation of the background
+    page, should *not be imported*.
 * `locale` directory: Localized strings, with one directory per locale. The
   Firefox format for locale identifiers is used (xx-YY where xx is the language
   code and YY the optional region code). The localization strings themselves are
   stored in the JSON format, like the one used by Chrome extensions. There is
   one JSON file per HTML page, file names of HTML page and JSON file should
   match.
 * `skin` directory: CSS files and any additional resources (images and fonts)
   required for these.