diff --git a/docs/docs/development.rst b/docs/docs/development.rst index 2df0d13b..e7621bda 100644 --- a/docs/docs/development.rst +++ b/docs/docs/development.rst @@ -41,25 +41,14 @@ The Jedi Core The core of Jedi consists of three parts: -- :ref:`API ` - :ref:`Parser ` - :ref:`Python code evaluation ` +- :ref:`API ` Most people are probably interested in `code evaluation `, because that's where all the magic happens. I need to introduce the ref:`parser ` first, because evaluate uses it extensively. -.. _dev-api: - -API (api.py and api_classes.py) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The API has been designed to be as usable as possible. The documentation can be -found `here `_. The API itself contains little code that needs -to be mentioned here. Generally I'm trying to be conservative with the API. -I'd rather not add new API features if they are not necessary, because it's -much harder to deprecate stuff than to add it later. - .. _parsing: Parser (parsing.py) @@ -74,6 +63,17 @@ Evaluation of python code (evaluate.py) .. automodule:: evaluate +.. _dev-api: + +API (api.py and api_classes.py) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The API has been designed to be as usable as possible. The documentation can be +found `here `_. The API itself contains little code that needs +to be mentioned here. Generally I'm trying to be conservative with the API. +I'd rather not add new API features if they are not necessary, because it's +much harder to deprecate stuff than to add it later. + .. _core-extensions: