diff --git a/doc/_templates/index.html b/doc/_templates/index.html
index a37579c29..a688d17c1 100644
--- a/doc/_templates/index.html
+++ b/doc/_templates/index.html
@@ -52,23 +52,25 @@
{%trans%}First steps with Sphinx{%endtrans%}
{%trans%}overview of basic tasks{%endtrans%}
- {%- if hasdoc('search') %} {%trans%}Search page{%endtrans%}
- {%trans%}search the documentation{%endtrans%} {%- endif %}
+ {%trans%}Tutorial{%endtrans%}
+ {%trans%}beginners tutorial{%endtrans%}
|
{%trans%}Contents{%endtrans%}
{%trans%}for a complete overview{%endtrans%}
|
- {%- if hasdoc('genindex') %} {%trans%}General Index{%endtrans%}
- {%trans%}all functions, classes, terms{%endtrans%} {%- endif %}
+ {%- if hasdoc('search') %}{%trans%}Search page{%endtrans%}
+ {%trans%}search the documentation{%endtrans%} {%- endif %}
|
{%trans%}Changes{%endtrans%}
{%trans%}release history{%endtrans%}
|
- |
+ {%- if hasdoc('genindex') %}{%trans%}General Index{%endtrans%}
+ {%trans%}all functions, classes, terms{%endtrans%}
{%- endif %}
+
|
diff --git a/doc/contents.rst b/doc/contents.rst
index eb6946292..21a27e233 100644
--- a/doc/contents.rst
+++ b/doc/contents.rst
@@ -7,6 +7,7 @@ Sphinx documentation contents
:maxdepth: 2
usage/index
+ tutorial/index
development/index
man/index
diff --git a/doc/tutorial/index.rst b/doc/tutorial/index.rst
new file mode 100644
index 000000000..81845c559
--- /dev/null
+++ b/doc/tutorial/index.rst
@@ -0,0 +1,25 @@
+.. _tutorial:
+
+===============
+Sphinx tutorial
+===============
+
+In this tutorial you will build a simple documentation project using Sphinx,
+and view it in your web browser as HTML.
+We will include narrative, handwritten documentation,
+as well as autogenerated API documentation.
+
+The tutorial is aimed towards people willing to learn
+the fundamentals of Sphinx,
+how projects are created and structured,
+and how to contribute to an existing project.
+To showcase Sphinx automatic documentation generation capabilities
+we will use Python, which is the default :term:`domain`:
+even though several other languages are supported,
+they all work in a similar way.
+
+To follow the tutorial you will need a working Python installation for development.
+We will use *Python virtual environments* to create our project,
+you can read more about them in the `Python Packaging User Guide`_.
+
+.. _Python Packaging User Guide: https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment