diff --git a/Shorewall-docs2/Documentation_Index.xml b/Shorewall-docs2/Documentation_Index.xml
index 3b8b15fd1..a83c66632 100644
--- a/Shorewall-docs2/Documentation_Index.xml
+++ b/Shorewall-docs2/Documentation_Index.xml
@@ -57,6 +57,73 @@
     </listitem>
   </itemizedlist>
 
+  <para>The following article is also recommended reading for
+  newcomers.</para>
+
+  <itemizedlist>
+    <listitem>
+      <para><ulink url="configuration_file_basics.htm">Configuration File
+      Basics</ulink><itemizedlist>
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#Comments">Comments
+            in configuration files</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#Continuation">Line
+            Continuation</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#INCLUDE">INCLUDE
+            Directive</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#Ports">Port
+            Numbers/Service
+            Names</ulink>configuration_file_basics.htm#Ports</para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#Ranges">Port
+            Ranges</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#Variables">Using
+            Shell Variables</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#dnsnames">Using
+            DNS Names</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink
+            url="configuration_file_basics.htm#Compliment">Complementing an IP
+            address or Subnet</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#IPRanges">IP
+            Address Ranges</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#Levels">Shorewall
+            Configurations (making a test configuration)</ulink></para>
+          </listitem>
+
+          <listitem>
+            <para><ulink url="configuration_file_basics.htm#MAC">Using MAC
+            Addresses in Shorewall</ulink></para>
+          </listitem>
+        </itemizedlist></para>
+    </listitem>
+  </itemizedlist>
+
   <para>The remainder of the Documentation supplements the QuickStart Guides.
   Please review the appropriate guide before trying to use this documentation
   directly.</para>
@@ -120,68 +187,6 @@
       (Description of all /sbin/shorewall commands)</para>
     </listitem>
 
-    <listitem>
-      <para><ulink url="configuration_file_basics.htm">Common configuration
-      file features&nbsp;</ulink><itemizedlist>
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#Comments">Comments
-            in configuration files</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#Continuation">Line
-            Continuation</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#INCLUDE">INCLUDE
-            Directive</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#Ports">Port
-            Numbers/Service
-            Names</ulink>configuration_file_basics.htm#Ports</para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#Ranges">Port
-            Ranges</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#Variables">Using
-            Shell Variables</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#dnsnames">Using
-            DNS Names</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink
-            url="configuration_file_basics.htm#Compliment">Complementing an IP
-            address or Subnet</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#IPRanges">IP
-            Address Ranges</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#Levels">Shorewall
-            Configurations (making a test configuration)</ulink></para>
-          </listitem>
-
-          <listitem>
-            <para><ulink url="configuration_file_basics.htm#MAC">Using MAC
-            Addresses in Shorewall</ulink></para>
-          </listitem>
-        </itemizedlist></para>
-    </listitem>
-
     <listitem>
       <para><ulink url="Documentation.htm">Configuration File Reference Manual
       </ulink><itemizedlist>