[pypy-commit] pypy improve-docs: RPython docs: split toctree on index page into sections (general, user documentation, writing your own interpreter, internals).

[Manuel Jacob]

Author: Manuel Jacob
Branch: improve-docs
Changeset: r72591:7a3cd5964521
Date: 2014-07-28 13:19 +0200
http://bitbucket.org/pypy/pypy/changeset/7a3cd5964521/

Log:	RPython docs: split toctree on index page into sections (general,
	user documentation, writing your own interpreter, internals).

diff --git a/rpython/doc/index.rst b/rpython/doc/index.rst
--- a/rpython/doc/index.rst
+++ b/rpython/doc/index.rst
@@ -14,21 +14,53 @@
 have a JIT in the first place.
 
 
-Table of Contents
+General
+-------
+
+.. toctree::
+   :maxdepth: 1
+
+   architecture
+   faq
+
+
+User Documentation
+------------------
+
+These documents are mainly interesting for users of interpreters written in
+RPython.
+
+.. toctree::
+   :maxdepth: 1
+
+   arm
+   windows
+
+
+Writing your own interpreter in RPython
+---------------------------------------
+
+.. toctree::
+   :maxdepth: 1
+
+   rpython
+   rlib
+   rffi
+
+
+RPython internals
 -----------------
 
 .. toctree::
    :maxdepth: 1
 
+   glossary
    getting-started
-   faq
-   rpython
-   rlib
-   rffi
+   dir-reference
+   jit/index
    translation
    rtyper
    garbage_collection
-   windows
 
 
 Indices and tables