Create a tutorial portal

doc/contents.rst

@@ -23,6 +23,7 @@ Sphinx documentation contents
    markdown
    extensions
    extdev/index
+   extdev/tutorials/index
    websupport
 
    faq

doc/develop.rst

@@ -100,7 +100,7 @@ This is the current list of contributed extensions in that repository:
 - zopeext: provide an ``autointerface`` directive for using `Zope interfaces`_
 
 
-See the :ref:`extension tutorial <exttut>` on getting started with writing your
+See the :ref:`extension tutorial <exttuttodo>` on getting started with writing your
 own extensions.
 
 

doc/extdev/index.rst

@@ -75,8 +75,9 @@ APIs used for writing extensions
 --------------------------------
 
 .. toctree::
+   :maxdepth: 2
 
-   tutorial
+   tutorials/index
    appapi
    envapi
    builderapi

doc/extdev/tutorials/index.rst

@@ -0,0 +1,10 @@
+.. _exttuttodoorials:
+
+Extension tutorials
+===================
+
+Refer to the following tutorials to get started with extension development.
+
+.. toctree::
+
+   todo_ext

doc/extdev/tutorials/todo_ext.rst

@@ -1,7 +1,7 @@
-.. _exttut:
+.. _exttuttodo:
 
-Tutorial: Writing a simple extension
-====================================
+Developing a `TODO` extension
+=============================
 
 This section is intended as a walkthrough for the creation of custom extensions.
 It covers the basics of writing and activating an extension, as well as

doc/faq.rst

@@ -33,7 +33,7 @@ How do I...
    ``sidebartoc`` block.
 
 ... write my own extension?
-   See the :ref:`extension tutorial <exttut>`.
+   See the :ref:`extension tutorial <exttuttodo>`.
 
 ... convert from my existing docs using MoinMoin markup?
    The easiest way is to convert to xhtml, then convert `xhtml to reST`_.