toc, fluffed up descriptions

1 files changed, 50 insertions, 19 deletions

diff --git a/htdocs/docs/index.html b/htdocs/docs/index.html
index c7bdd71..6f39f40 100755
--- a/htdocs/docs/index.html
+++ b/htdocs/docs/index.html
@@ -1,5 +1,5 @@
-<!--#set var="revision" value="\$Id: index.html,v 1.10 2004-05-09 15:56:50 link Exp $"
---><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $"
+<!--#set var="revision" value="\$Id: index.html,v 1.11 2005-06-03 04:59:28 ot Exp $"
+--><!--#set var="date" value="\$Date: 2005-06-03 04:59:28 $"
 --><!--#set var="title" value="Documentation Index for The W3C Markup Validation Service"
 --><!--#set var="relroot" value="../"
 --><!--#include virtual="../header.html" -->
@@ -12,37 +12,68 @@
       new elements, and eagerly welcome	<a href="../feedback.html">feedback and additions</a>!
     </p>
 
-<h3>For beginners and experts alike</h3>
+<h3 id="TableOfContents">Table of contents</h3>
+<div id="toc">
+<ul>
+  <li><a href="#docs_all">For beginners and experts alike</a>
+    <ol>
+      <li><a href="#doc_help">Help and FAQ</a></li>
+      <li><a href="#doc_user">User's Guide</a></li>
+      <li><a href="#doc_errors">Error messages and explanations</li>
+      <li><a href="#doc_favelets">Favelets</a></li>
+      <li><a href="#doc_accesskeys">accesskeys</a></li>
+    </ol>
+  </li>
+  
+  <li><a href="docs_experts">Experts only</a>
+    <ol>
+      <li><a href="#doc_sgml">SGML and the Validator</a></li>
+      <li><a href="#doc_source">Download / Source</a></li>
+      <li><a href="#doc_install">Installation Guide</a></li>
+      <li><a href="#doc_devel">Developer Information</a></li>
+  </li>
+</ol>
+</div>
+
+<h3 id="docs_all">For beginners and experts alike</h3>
     <dl>
-      <dt>W3C Markup Validator 
+      <dt id="doc_help">W3C Markup Validator 
 	<a href="help.html">Help and <abbr title="Frequently Asked Questions">FAQ</abbr></a></dt>
       <dd><p>A quick intro and help to get you started, with answers to
-	Frequently Asked Questions. <strong>Read this first</strong>.</p></dd>
-      <dt>W3C Markup Validator <a href="users.html">User's Guide</a></dt>
-      <dd><p>The User's Guide and tips for the W3C Markup Validator.</p></dd>
-      <dt><a href="../favelets.html">Favelets</a></dt>
-      <dd><p>Favelets / Bookmarklets: Validation made fast and easy</p></dd>
-      <dt><a href="../accesskeys.html">Access Keys</a></dt>
-      <dd><p>Quick navigation with access keys.</p></dd>
-      <dt>W3C Markup Validator <a href="errors.html">Error Messages</a></dt>
-      <dd><p>Explanations of common error messages.</p></dd>
+	Frequently Asked Questions. <strong>Read this first</strong>.</p>
+	<p>This document has a lot of information on how the validator works, answers to frequent 
+	questions about "why did the validator say that...", as well as pointers to technical 
+	and policy documents.</p> </dd>
+      <dt id="doc_user">W3C Markup Validator <a href="users.html">User's Guide</a></dt>
+      <dd><p>The User's Guide and tips for the W3C Markup Validator. It notably lists 
+      and explains the available options.</p></dd>
+      <dt id="doc_errors">W3C Markup Validator <a href="errors.html">Error Messages</a></dt>
+      <dd><p>Explanations of common error messages.</p><p>This list conveniently gathers
+      all the error messages currently used by the validator when processing Web documents, 
+      and the community-contributed explanations to these error messages, whenever available.</p>
+      </dd>
+      <dt id="doc_favelets"><a href="../favelets.html">Favelets</a></dt>
+      <dd><p>Favelets, <acronym title="also known as">a.k.a</acronym> Bookmarklets: Validation made fast and easy</p></dd>
+      <dt id="doc_accesskeys"><a href="../accesskeys.html">Access Keys</a></dt>
+      <dd><p>Quick navigation with the access keys used throughout this site.</p></dd>
+
 </dl>
 
-<h3>Experts only</h3>
+<h3 id="docs_experts">Experts only</h3>
 <dl>
-      <dt><a href="sgml.html">SGML (basics) and the Markup Validator</a></dt>
+      <dt id="doc_sgml"><a href="sgml.html">SGML (basics) and the Markup Validator</a></dt>
       <dd>
         <p>
           A quick introduction to SGML concepts as they apply to the
           Validator with links to further information.
         </p>
       </dd>
-      <dt><a href="../source/">Download / Source</a></dt>
-      <dd><p>Information on source code availability and download instructions for the Markup Validator</p></dd>
-      <dt><a href="install.html">Installation Guide</a></dt>
+      <dt id="doc_source"><a href="../source/">Download / Source</a></dt>
+      <dd><p>Information on source code availability and download instructions for the Markup Validator.</p></dd>
+      <dt id="doc_install"><a href="install.html">Installation Guide</a></dt>
       <dd><p>Step-by step guide for the installation of the Markup Validator
       on <em>your</em> server.</p></dd>
-      <dt><a href="devel.html">Developer Information</a></dt>
+      <dt id="doc_devel"><a href="devel.html">Developer Information</a></dt>
       <dd><p>Information for programmers wanting to play with the validator's code, and/or contribute to its development.</p></dd>
     </dl>