From d08c3677d12f80bcbcaff22f4537ae5e7fc14030 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Juan=20Luis=20Cano=20Rodr=C3=ADguez?= Date: Mon, 21 Jun 2021 07:30:02 +0200 Subject: [PATCH] Avoid reference to earlier content --- doc/tutorial/index.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/doc/tutorial/index.rst b/doc/tutorial/index.rst index e98e718e1..94878548f 100644 --- a/doc/tutorial/index.rst +++ b/doc/tutorial/index.rst @@ -318,10 +318,11 @@ Narrative documentation in Sphinx Inserting documents in the project hierarchy ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -As discussed at the beginning, ``index.rst`` is the :term:`master document`, -whose main function is to serve as a welcome page and to contain the root of -the "table of contents tree" (or *toctree*). Sphinx allows you to assemble -a project from different files, which is helpful when the project grows. +The file ``index.rst`` created by ``sphinx-quickstart`` is the :term:`master +document`, whose main function is to serve as a welcome page and to contain the +root of the "table of contents tree" (or *toctree*). Sphinx allows you to +assemble a project from different files, which is helpful when the project +grows. As an example, create a new file ``docs/source/usage.rst`` (next to ``index.rst``) with these contents: