From 954ac5f188be210a773aa5e0ef05507a3bc2aa5a Mon Sep 17 00:00:00 2001
From: Phil Crosby
Date: Sun, 22 Jul 2012 13:53:46 -0700
Subject: Document what the css reset is used for.

---
 help_dialog.html |  1 +
 vimium.css       | 13 +++++++++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/help_dialog.html b/help_dialog.html
index 7bd08829..5e188406 100644
--- a/help_dialog.html
+++ b/help_dialog.html
@@ -2,6 +2,7 @@
   This is shown when typing "?". This HTML is loaded by the background page and then populated with the
   latest keybindings information before displaying.
 -->
+
   <!-- Note that the template placeholders (e.g. "pageNavigation") will be filled in by the background
        page with the up-to-date key bindings when the dialog is shown. -->
   <div id="vimiumHelpDialog" class="vimiumReset">
diff --git a/vimium.css b/vimium.css
index 58bb0151..8464a74d 100644
--- a/vimium.css
+++ b/vimium.css
@@ -1,5 +1,14 @@
-/* All of these declarations contain more specifiers than nesscesary to increase their specificity and help to
-   ensure they override broad CSS declarations by the website vimium overlays. */
+/*
+ * Many CSS class names in this file use the verbose "vimiumXYZ" as the class name. This is so we don't
+ * use the same CSS class names that the page is using, so the page's CSS doesn't mess with the style of our
+ * Vimium dialogs.
+ */
+
+/*
+ * This vimiumReset class can be added to any of our UI elements to give it a clean slate. This is useful in
+ * case the page has declared a broad rule like "a { padding: 50px; }" which will mess up our UI. These
+ * declarations contain more specifiers than necessary to increase their specificity (precedence).
+ */
 .vimiumReset,
 div.vimiumReset,
 span.vimiumReset,
-- 
cgit v1.2.3