From 62ead4092f86b45ba135a541850b84370a6d5fa9 Mon Sep 17 00:00:00 2001
From: squidfunk <martin.donath@squidfunk.com>
Date: Tue, 26 Nov 2019 10:36:04 +0100
Subject: [PATCH] Documentation

---
 src/base.html | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/src/base.html b/src/base.html
index 18bfde646..3a5a6a745 100644
--- a/src/base.html
+++ b/src/base.html
@@ -54,7 +54,7 @@
             (anchor ? '#' + anchor : '')
         </script>
 
-        <!-- no-js fallback -->
+        <!-- Fallback in case JavaScript is not available -->
         <meta http-equiv="refresh" content="0; url={{ page.meta.redirect }}" />
         <meta name="robots" content="noindex" />
         <link rel="canonical" href="{{ page.meta.redirect }}" />
@@ -92,10 +92,8 @@
       {% endif %}
     {% endblock %}
 
-    <!-- Stylesheets -->
+    <!-- Theme-related stylesheets -->
     {% block styles %}
-
-      <!-- Theme-related stylesheets -->
       <link
         rel="stylesheet"
         type="text/css"
@@ -177,7 +175,7 @@
       <link rel="stylesheet" type="text/css" href="{{ path | url }}" />
     {% endfor %}
 
-    <!-- Analytic scripts -->
+    <!-- Analytics -->
     {% block analytics %}
       {% if config.google_analytics %}
         {% include "partials/integrations/analytics.html" %}
@@ -246,7 +244,7 @@
       for="__drawer"
     ></label>
 
-    <!-- Render "skip to content" link -->
+    <!-- Link to skip to content -->
     {% if page.toc | first is defined %}
       <a href="{{ (page.toc | first).url }}" tabindex="1" class="md-skip">
         {{ lang.t('skip.link.title') }}
@@ -273,7 +271,7 @@
         {% include "partials/tabs.html" %}
       {% endif %}
 
-      <!-- Main container -->
+      <!-- Main area -->
       <main class="md-main" role="main">
         <div class="md-main__inner md-grid" data-md-component="main">
 
@@ -418,6 +416,8 @@
         {%- endfor -%}
         {{ translations | tojson }}
       </script>
+
+      <!-- Application initialization -->
       <script>
         app({
           version: "{{ mkdocs_version }}",
@@ -426,6 +426,8 @@
           }
         });
       </script>
+
+      <!-- Custom JavaScript -->
       {% for path in config["extra_javascript"] %}
         <script src="{{ path | url }}"></script>
       {% endfor %}