diff --git a/favourite-colour/README.md b/favourite-colour/README.md
index 820fc08..e0cc781 100644
--- a/favourite-colour/README.md
+++ b/favourite-colour/README.md
@@ -1,15 +1,15 @@
# Favourite Colour
-Shows and stores your favourite colour, in storage.sync in the about:addons page for the add-on.
+Shows and stores your favourite colour, in storage.sync in the extension's about:addons page.
Demonstrates:
* storing data with storage.sync
+* reading data from storage.managed
+* creating an options page and opening it with `runtime.openOptionsPage()`
+* best practice for supporting automatic theme switching (dark theme) in the options page
-* reading data from storage.managed,
-* creating an options page and opening it with `runtime.openOptionsPage()`.
-
-To have Firefox read data from storage.managed, create a file with the following contents:
+To have Firefox read data from storage.managed, create a file with this content:
{
"name": "favourite-colour-examples@mozilla.org",
diff --git a/favourite-colour/options.html b/favourite-colour/options.html
index 6b11728..604761a 100644
--- a/favourite-colour/options.html
+++ b/favourite-colour/options.html
@@ -3,6 +3,7 @@
+