tweaks

sphinx-doc · Oct 12, 2024 · 5e6da0a · 5e6da0a
1 parent ae96d27
commit 5e6da0a
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 8 deletions.
diff --git a/doc/internals/contributing.rst b/doc/internals/contributing.rst
@@ -270,14 +270,14 @@ you to preview in :file:`build/sphinx/html`.
 
 You can also build a **live version of the documentation** that you can preview
 in the browser. It will detect changes and reload the page any time you make
-edits. To do so, use `sphinx-autobuild
-<https://github.com/sphinx-doc/sphinx-autobuild>`_ to run the following
-command:
+edits.
+To do so, use `sphinx-autobuild`_ to run the following command:
 
 .. code-block:: shell
 
    sphinx-autobuild ./doc ./build/sphinx/
 
+.. _sphinx-autobuild: https://github.com/sphinx-doc/sphinx-autobuild
 
 Translations
 ~~~~~~~~~~~~

diff --git a/doc/usage/quickstart.rst b/doc/usage/quickstart.rst
@@ -149,14 +149,15 @@ Sphinx will build HTML files.
    for all options that :program:`sphinx-build` supports.
 
 You can also build a **live version of the documentation** that you can preview
-in the browser. It will detect changes and reload the page any time you make
-edits. To do so, use `sphinx-autobuild
-<https://github.com/sphinx-doc/sphinx-autobuild>`_ to run the following
-command:
+in the browser.
+It will detect changes and reload the page any time you make edits.
+To do so, use `sphinx-autobuild`_ to run the following command:
 
 .. code-block:: console
 
-   $ sphinx-autobuild sourcedir outputdir
+   $ sphinx-autobuild source-dir output-dir
+
+.. _sphinx-autobuild: https://github.com/sphinx-doc/sphinx-autobuild
 
 However, :program:`sphinx-quickstart` script creates a :file:`Makefile` and a
 :file:`make.bat` which make life even easier for you. These can be executed by