From ceecd0556dc6f013b5b62fedb12453b8ae3b8067 Mon Sep 17 00:00:00 2001 From: KHMANJUNATH Date: Thu, 9 Jan 2020 18:40:28 +0530 Subject: [PATCH] Improved ReST formatting in docs/README.rst. Co-authored-by: Mariusz Felisiak --- docs/README.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/README.rst b/docs/README.rst index f34aa8782a..c9ed46ddfc 100644 --- a/docs/README.rst +++ b/docs/README.rst @@ -1,7 +1,7 @@ The documentation in this tree is in plain text files and can be viewed using any text file viewer. -It uses ReST (reStructuredText) [1], and the Sphinx documentation system [2]. +It uses `ReST`_ (reStructuredText), and the `Sphinx`_ documentation system. This allows it to be built into other forms for easier viewing and browsing. To create an HTML version of the docs: @@ -11,7 +11,8 @@ To create an HTML version of the docs: * In this docs/ directory, type ``make html`` (or ``make.bat html`` on Windows) at a shell prompt. -The documentation in _build/html/index.html can then be viewed in a web browser. +The documentation in ``_build/html/index.html`` can then be viewed in a web +browser. -[1] http://docutils.sourceforge.net/rst.html -[2] http://sphinx-doc.org/ +.. _ReST: https://docutils.sourceforge.io/rst.html +.. _Sphinx: http://sphinx-doc.org