diff --git a/docs/docs/development.rst b/docs/docs/development.rst
index 17e51d97..0e107c43 100644
--- a/docs/docs/development.rst
+++ b/docs/docs/development.rst
@@ -54,33 +54,15 @@ because that's where all the magic happens. I need to introduce the :ref:`parser
 
 .. _parser:
 
-Parser (parser/__init__.py)
+Parser
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. automodule:: jedi.parser
+Jedi used to have it's internal parser, however this is now a separate project
+and is called `parso <http://parso.readthedocs.io>`_.
 
-Parser Tree (parser/tree.py)
-++++++++++++++++++++++++++++++++++++++++++++++++
-
-.. automodule:: jedi.parser.tree
-
-Class inheritance diagram:
-
-.. inheritance-diagram::
-   Module
-   Class
-   Function
-   Lambda
-   Flow
-   ForStmt
-   Import
-   ExprStmt
-   Param
-   Name
-   CompFor
-   :parts: 1
-
-.. _evaluate:
+The parser creates a syntax tree that |jedi| analyses and tries to understand.
+The grammar that this parsers uses is very similar to the official Python
+`grammar files <https://docs.python.org/3/reference/grammar.html>`_.
 
 Evaluation of python code (evaluate/__init__.py)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -156,13 +138,6 @@ Parameter completion (evaluate/dynamic.py)
 .. automodule:: jedi.evaluate.dynamic
 
 
-.. _diff-parser:
-
-Diff Parser (parser/diff.py)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: jedi.parser.python.diff
-
 .. _docstrings:
 
 Docstrings (evaluate/docstrings.py)
diff --git a/docs/docs/parser.rst b/docs/docs/parser.rst
deleted file mode 100644
index 9ec82012..00000000
--- a/docs/docs/parser.rst
+++ /dev/null
@@ -1,36 +0,0 @@
-.. _xxx:
-
-Parser Tree
-===========
-
-Usage
------
-
-.. automodule:: jedi.parser.python
-    :members:
-    :undoc-members:
-
-
-Parser Tree Base Class
-----------------------
-
-All nodes and leaves have these methods/properties:
-
-.. autoclass:: jedi.parser.tree.NodeOrLeaf
-    :members:
-    :undoc-members:
-
-
-Python Parser Tree
-------------------
-
-.. automodule:: jedi.parser.python.tree
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-
-Utility
--------
-
-.. autofunction:: jedi.parser.tree.search_ancestor