Merge pull request #11 from zopefoundation/demote-old-guide

Demote old guide

documentation/articles/index.rst

@@ -10,35 +10,17 @@ Contents
    ZODB-overview.rst
    ZODB1.rst
    ZODB2.rst
+   old-guide/index
    multi-zodb-gc.rst
 
 
 Other ZODB Resources
 --------------------
 
-- `ZODB/ZEO Programming Guide <../zodbguide/index.html>`_
-
-- Jim Fulton's `Introduction to the Zope Object Database   <http://www.python.org/workshops/2000-01/proceedings/papers/fulton/zodb3.html>`_
-
 - IBM developerWorks `Example-driven ZODB
   <http://www.ibm.com/developerworks/aix/library/au-zodb/>`_
 
-- Martin Faassen's `A misconception about the ZODB
-  <http://faassen.n--tree.net/blog/view/weblog/2008/06/20/0>`_
-
 - `How To Love ZODB and Forget RDBMS
   <http://zope.org/Members/adytumsolutions/HowToLoveZODB_PartI>`_
 
-- `ZODB wiki <http://www.zope.org/Wikis/ZODB/FrontPage>`_ and `Documentation
-  page <http://wiki.zope.org/ZODB/Documentation>`_ and `Historical pages
-  <http://wiki.zope.org/ZODB/HistoricalPages>`_
-
 - `Very old ZODB wiki <http://www.zope.org/Members/jim/ZODB/FrontPage>`_
-
-- `ZODB-dev <http://mail.zope.org/mailman/listinfo/zodb-dev>`_ mailing list
-  and `archive <http://mail.zope.org/pipermail/zodb-dev/>`_
-
-- `Administering Zope 2 - ZODB
-  <http://wiki.zope.org/zope2/ZODBZopeObjectDatabase>`_
-
-- `Add-on software for ZODB <http://wiki.zope.org/ZODB/ZODBAddOns>`_

documentation/articles/old-guide/index.rst

+===============================
+Very old ZODB programming guide
+===============================
+
+
+    This guide is based heavily on the work of A. M. Kuchling who wrote the
+    original guide back in 2002 and which was published under the GNU Free
+    Documentation License, Version 1.1. See the appendix entitled "GNU Free
+    Documentation License" for more information.
+
+.. toctree::
+   :maxdepth: 2
+
+   introduction.rst
+   prog-zodb.rst
+   zeo.rst
+   transactions.rst
+   modules.rst
+   links.rst
+   gfdl.rst

documentation/guide/index.rst

@@ -2,22 +2,22 @@
 ZODB programming guide
 ======================
 
+This guide consists of a collection of topics that should be of
+interest to most developers.  They're provuded in order of importance,
+which is also an order from least to most advanced, but they can be
+read in any order.
 
-    This guide is based heavily on the work of A. M. Kuchling who wrote the
-    original guide back in 2002 and which was published under the GNU Free
-    Documentation License, Version 1.1. See the appendix entitled "GNU Free
-    Documentation License" for more information.
-
-Contents
---------
+If you haven't yet, you should read the :ref:`Tutorial <tutorial-label>`.
 
 .. toctree::
    :maxdepth: 2
 
-   introduction.rst
-   prog-zodb.rst
-   zeo.rst
-   transactions.rst
-   modules.rst
-   links.rst
-   gfdl.rst
+   writing-persistent-objects.rst
+   transaction.rst
+   storages.rst
+   configuration.rst
+   threading.rst
+   packing-and-garbage-collection.rst
+   blobs.rst
+   schema-migration.rst
+   multi-databases.rst

documentation/tutorial.rst

+.. _tutorial-label:
+
 ========
 Tutorial
 ========