diff --git a/doc/format.rst b/doc/format.rst
index cdeec0b8..9d92569a 100644
--- a/doc/format.rst
+++ b/doc/format.rst
@@ -8,7 +8,7 @@ numpydoc docstring guide
.. Contents::
This document describes the syntax and best practices for docstrings used with
-the numpydoc extension for `Sphinx `__.
+the numpydoc extension for Sphinx_.
.. Note::
@@ -21,21 +21,23 @@ the numpydoc extension for `Sphinx `__.
Overview
--------
We mostly follow the standard Python style conventions as described here:
- * `Style Guide for C Code `_
- * `Style Guide for Python Code `_
- * `Docstring Conventions `_
+ * `Style Guide for C Code `_
+ * `Style Guide for Python Code `_
+ * `Docstring Conventions `_
Additional PEPs of interest regarding documentation of code:
- * `Docstring Processing Framework `_
- * `Docutils Design Specification `_
+ * `Docstring Processing Framework `_
+ * `Docutils Design Specification `_
Use a code checker:
- * `pylint `_
- * `pyflakes `_
- * `pep8.py `_
- * `flake8 `_
- * `vim-flake8 `_ plugin for
- automatically checking syntax and style with flake8
+ * pylint_: a Python static code analysis tool.
+ * pyflakes_: a tool to check Python code for errors by parsing
+ the source file instead of importing it.
+ * pycodestyle_: (formerly ``pep8``) a tool to check Python code against
+ some of the style conventions in PEP 8.
+ * flake8_: a tool that glues together ``pycodestyle``, ``pyflakes``,
+ ``mccabe`` to check the style and quality of Python code.
+ * vim-flake8_: a ``flake8`` plugin for Vim.
Import conventions
------------------
@@ -332,7 +334,7 @@ The sections of a function's docstring are:
An optional section that provides additional information about the
code, possibly including a discussion of the algorithm. This
section may include mathematical equations, written in
- `LaTeX `_ format::
+ `LaTeX `_ format::
The FFT is a fast implementation of the discrete Fourier transform:
@@ -686,6 +688,11 @@ Conclusion
This document itself was written in ReStructuredText.
:ref:`An example ` of the format shown here is available.
-.. _SciPy: http://www.scipy.org
-.. _numpy-discussion list: http://scipy.org/scipylib/mailing-lists.html
-.. _Sphinx: http://sphinx.pocoo.org
+.. _Sphinx: https://www.sphinx-doc.org/
+.. _pylint: https://pypi.org/project/pylint/
+.. _pyflakes: https://pypi.python.org/pypi/pyflakes/
+.. _pycodestyle: https://pypi.org/project/pycodestyle/
+.. _flake8: https://pypi.python.org/pypi/flake8/
+.. _vim-flake8: https://github.com/nvie/vim-flake8
+.. _SciPy: https://www.scipy.org
+.. _numpy-discussion list: https://scipy.org/scipylib/mailing-lists.html