commit b7a8d4e1cf07895b3b186c30ac40bebdaa248ddb
Author: Joel Pittet <joel@pittet.ca>
Date:   Tue May 7 18:56:57 2013 -0700

    doc tweaks from #42

diff --git a/core/themes/seven/seven.theme b/core/themes/seven/seven.theme
index f1af7fd..c0447d0 100644
--- a/core/themes/seven/seven.theme
+++ b/core/themes/seven/seven.theme
@@ -6,12 +6,12 @@
  */
 
 /**
- * Implements hook_preprocess_HOOK() for maintenance-page.tpl.php.
+ * Implements hook_preprocess_HOOK() for maintenance-page.html.twig.
  */
 function seven_preprocess_maintenance_page(&$vars) {
   // While markup for normal pages is split into page.tpl.php and html.tpl.php,
   // the markup for the maintenance page is all in the single
-  // maintenance-page.tpl.php template. So, to have what's done in
+  // maintenance-page.html.twig template. So, to have what's done in
   // seven_preprocess_html() also happen on the maintenance page, it has to be
   // called here.
   seven_preprocess_html($vars);
@@ -27,7 +27,7 @@ function seven_preprocess_html(&$vars) {
 }
 
 /**
- * Implements hook_preprocess_HOOK() for page.html.twig.
+ * Implements hook_preprocess_HOOK() for page.tpl.php.
  */
 function seven_preprocess_page(&$vars) {
   $vars['primary_local_tasks'] = $vars['tabs'];
@@ -51,7 +51,8 @@ function seven_preprocess_node_add_list(&$variables) {
 }
 
 /**
- * Implements hook_preprocess_HOOK() for custom-block-add-list.html.twig
+ * Implements hook_preprocess_HOOK() for custom-block-add-list.html.twig.
+ *
  * Add variables for the label and the path separately.
  *
  * Displays the list of available custom block types for creation, adding
@@ -70,7 +71,6 @@ function seven_preprocess_custom_block_add_list(&$variables) {
 /**
  * Implements hook_preprocess_HOOK() for theme_admin_block_content().
  *
- * Prepare variables for administrative content block templates.
  * Uses an unordered list markup in both compact and extended mode.
  */
 function seven_preprocess_admin_block_content(&$variables) {
diff --git a/core/themes/seven/templates/admin-block-content.html.twig b/core/themes/seven/templates/admin-block-content.html.twig
index a65fb30..caed957 100644
--- a/core/themes/seven/templates/admin-block-content.html.twig
+++ b/core/themes/seven/templates/admin-block-content.html.twig
@@ -1,10 +1,10 @@
 {#
 /**
  * @file
- * Default theme implementation for the content of an administrative block.
+ * Seven's theme implementation for the content of an administrative block.
  *
  * Available variables:
- * - content: List of administrative menu items.
+ * - content: List of administrative menu items. Each menu item contains:
  *   - path: Path to the admin section.
  *   - label: Short name of the section.
  *   - description: Description of the administrative menu item.
@@ -12,6 +12,7 @@
  *
  * @see template_preprocess()
  * @see template_preprocess_admin_block_content()
+ * @see seven_preprocess_custom_block_add_list()
  *
  * @ingroup themeable
  */
diff --git a/core/themes/seven/templates/custom-block-add-list.html.twig b/core/themes/seven/templates/custom-block-add-list.html.twig
index e65809e..ebd420d 100644
--- a/core/themes/seven/templates/custom-block-add-list.html.twig
+++ b/core/themes/seven/templates/custom-block-add-list.html.twig
@@ -7,6 +7,7 @@
  *
  * Available variables:
  * - types: A collection of all the available custom block types.
+ *   Each type contains:
  *   - type: The custom block type, containing all the items below.
  *   - link: A link to add a block of this type.
  *   - description: A description of this custom block type.
@@ -15,6 +16,7 @@
  *
  * @see template_preprocess()
  * @see template_preprocess_custom_block_add_list()
+ * @see seven_preprocess_custom_block_add_list()
  *
  * @ingroup themeable
  */
diff --git a/core/themes/seven/templates/maintenance-page.html.twig b/core/themes/seven/templates/maintenance-page.html.twig
index 5df64db..9730620 100644
--- a/core/themes/seven/templates/maintenance-page.html.twig
+++ b/core/themes/seven/templates/maintenance-page.html.twig
@@ -49,7 +49,7 @@
 
   </div>
 
-  <footer id="footer" role="contentinfo">
+  <footer role="contentinfo">
     {{ page_bottom }}
   </footer>
 
diff --git a/core/themes/seven/templates/node-add-list.html.twig b/core/themes/seven/templates/node-add-list.html.twig
index fff306b..bd79fe1 100644
--- a/core/themes/seven/templates/node-add-list.html.twig
+++ b/core/themes/seven/templates/node-add-list.html.twig
@@ -1,16 +1,16 @@
 {#
 /**
  * @file
- * Default theme implementation to list the available types for content
- * creation.
+ * Seven's theme implementation to list node types available for adding content.
  *
  * Available variables:
- * - types: List of content types.
+ * - types: List of content types. Each content type contains:
  *   - add_link: Link to create a piece of content of this type.
  *   - description: Description of this type of content.
  *
  * @see template_preprocess()
  * @see template_preprocess_node_add_list()
+ * @see seven_preprocess_node_add_list()
  *
  * @ingroup themeable
  */