diff --git a/docs/docs/repl.rst b/docs/docs/repl.rst
new file mode 100644
index 00000000..e911e46e
--- /dev/null
+++ b/docs/docs/repl.rst
@@ -0,0 +1,8 @@
+.. include:: ../global.rst
+
+How to use Jedi from Python interpreter
+=======================================
+
+.. automodule:: jedi.replstartup
+
+.. autofunction:: jedi.utils.setup_readline
diff --git a/docs/index.rst b/docs/index.rst
index c8e518ea..9f53f667 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -22,6 +22,7 @@ Docs
 
    docs/installation
    docs/features
+   docs/repl
    docs/recipes
    docs/plugin-api
    docs/history