Update the documentation structure

Author: rlouf

doc/dev_start_guide.rst

@@ -16,8 +16,6 @@ This is a good way to make sure that proposed changes will be accepted.
 Resources
 =========
 
-See :ref:`aesara-community` for a list of Aesara resources.
-
 The Theano Google group is also relevant to (early) Aesara versions:
 `theano-dev`_.
 
@@ -76,9 +74,6 @@ Documentation and docstrings
   syntax. ``:py`` can be omitted, see e.g. this
   `stackoverflow answer <http://stackoverflow.com/a/7754189>`_.
 
-* See :ref:`metadocumentation`, for some information on how to generate the
-  documentation.
-
 
 A Docstring Example
 ~~~~~~~~~~~~~~~~~~~

doc/extending/creating_a_c_op.rst renamed to doc/extend/backend/creating_a_c_op.rst

@@ -0,0 +1,11 @@
+.. _extend_backend:
+
+Extend a backend
+================
+
+.. toctree::
+    :maxdepth: 1
+
+    creating_a_c_op
+    creating_a_numba_jax_op
+    ctype

doc/extending/creating_a_numba_jax_op.rst renamed to doc/extend/backend/creating_a_numba_jax_op.rst

@@ -1,9 +1,7 @@
+.. _extend:
 
-.. _extending:
-
-================
-Extending Aesara
-================
+Extend Aesara
+=============
 
 This advanced tutorial is for users who want to extend Aesara with new :class:`Type`\s,
 new operations (i.e. :class:`Op`\s), and new graph rewrites. This first page of the
@@ -19,32 +17,9 @@ Along the way, this tutorial also introduces many aspects of how Aesara works,
 so it is also good for you if you are interested in getting more under the hood
 with Aesara itself.
 
-.. note::
-
-    Before tackling this more advanced presentation, it is highly recommended
-    to read the introductory :ref:`Tutorial<tutorial>`, especially the sections
-    that introduce the Aesara graphs, as providing a novel Aesara :class:`Op` requires a
-    basic understanting of the Aesara graphs.
-
-    See also the :ref:`dev_start_guide` for information regarding the
-    versioning framework, namely about Git and GitHub, regarding the
-    development workflow and how to make a quality contribution.
-
 .. toctree::
+   :caption: Extend Aesara
 
-    graphstructures
-    graph_rewriting
-    op
-    creating_an_op
-    creating_a_c_op
-    creating_a_numba_jax_op
-    pipeline
-    type
-    ctype
-    inplace
-    scan
-    other_ops
-    using_params
-    unittest
-    extending_faq
-    tips
+   op/index
+   rewrite
+   backend/index

doc/extending/ctype.rst renamed to doc/extend/backend/ctype.rst

@@ -1,4 +1,3 @@
-
 .. _creating_an_op:
 
 Creating a new :class:`Op`: Python implementation
@@ -734,9 +733,6 @@ already do this for you. If you implement your own :meth:`setUp` method,
 don't forget to call the parent :meth:`setUp` method.
 
 
-:download:`Solution<extending_aesara_solution_1.py>`
-
-
 :func:`as_op`
 ---------------------
 
@@ -842,7 +838,7 @@ Final Note
 ----------
 
 A more extensive discussion of this section's content may be found in
-the advanced tutorial :ref:`Extending Aesara<extending>`.
+the advanced tutorial :ref:`Extending Aesara<extend>`.
 
 The section :ref:`Other Ops <other_ops>` includes more instructions for
 the following specific cases:

doc/extend/backend/index.rst

@@ -1,17 +1,11 @@
-====
-Tips
-====
+.. _extend_op:
 
-
-..
-   Reusing outputs
-   ===============
-
-   .. todo:: Write this.
+Add a new Op
+============
 
 
 Don't define new :class:`Op`\s unless you have to
-=================================================
+-------------------------------------------------
 
 It is usually not useful to define :class:`Op`\s that can be easily
 implemented using other already existing :class:`Op`\s. For example, instead of
@@ -33,23 +27,16 @@ contiguous vectors/matrices of doubles...
 
 
 Use Aesara's high order :class:`Op`\s when applicable
-=====================================================
+-----------------------------------------------------
 
 Aesara provides some generic :class:`Op` classes which allow you to generate a
 lot of :class:`Op`\s at a lesser effort. For instance, :class:`Elemwise` can be used to
 make :term:`elemwise` operations easily, whereas :class:`DimShuffle` can be
 used to make transpose-like transformations. These higher order :class:`Op`\s
 are mostly tensor-related, as this is Aesara's specialty.
 
+.. toctree::
+    :maxdepth: 1
 
-..
-   .. _opchecklist:
-
-   :class:`Op` Checklist
-   =====================
-
-   Use this list to make sure you haven't forgotten anything when
-   defining a new :class:`Op`. It might not be exhaustive but it covers a lot of
-   common mistakes.
-
-   .. todo:: Write a list.
+    creating_an_op
+    inplace

doc/extending/index.rst renamed to doc/extend/index.rst

@@ -0,0 +1,3 @@
+=================
+Add a new rewrite
+=================