docs/source/index.rst
changeset 3327 512eb20b0c3d
parent 3324 e1b661e5f494
child 3335 dca0a0de468c
--- a/docs/source/index.rst	Mon Feb 08 18:17:33 2010 +0000
+++ b/docs/source/index.rst	Mon Feb 08 22:28:42 2010 +0000
@@ -3,18 +3,33 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to the Reportlab PDF Library documentation!
-=====================================
+===================================
+ReportLab PDF Toolkit documentation
+===================================
+
+.. rubric:: API references and more for the ReportLab PDF Toolkit
+
 
 Contents:
 
 .. toctree::
    :maxdepth: 2
 
+   Library reference <lib.rst>
+    
+
 Actually, that's an exaggeration.  We're just playing with Sphinx at the moment.
 Pay no attention to the Sphinx docs until this page says something more
 constructive!
 
+We're planning to use Sphinx for the automated API references.  We have
+always been able to make our own documents in PDF, without using other
+peoples' libraries,. and don't want to back away from this. So, the main
+User Guide will remain in PDF format for now.  However, programmers need
+API refs online, and we want to learn Sphinx (and use rst2pdf) in due
+course.
+
+ :ref:`API reference <api>` |
 
 Indices and tables
 ==================
@@ -23,3 +38,5 @@
 * :ref:`modindex`
 * :ref:`search`
 
+
+