diff options
| -rw-r--r-- | doc/HOWTO_RELEASE.rst.txt | 16 | ||||
| -rw-r--r-- | doc/source/conf.py | 3 | ||||
| -rw-r--r-- | doc/source/dev/howto-docs.rst | 7 | ||||
| -rw-r--r-- | numpy/doc/dispatch.py | 2 | ||||
| -rw-r--r-- | numpy/lib/format.py | 4 |
5 files changed, 17 insertions, 15 deletions
diff --git a/doc/HOWTO_RELEASE.rst.txt b/doc/HOWTO_RELEASE.rst.txt index 6af8d9ca6..c3abbfde3 100644 --- a/doc/HOWTO_RELEASE.rst.txt +++ b/doc/HOWTO_RELEASE.rst.txt @@ -40,16 +40,17 @@ Release Scripts Supported platforms and versions ================================ -`NEP 29`_ outlines which Python versions are supported; For the first half of -2020, this will be Python >= 3.6. We test NumPy against all these versions -every time we merge code to master. Binary installers may be available for a -subset of these versions (see below). +:doc:`NEP 29<neps:nep-0029-deprecation_policy>` outlines which Python versions +are supported; For the first half of 2020, this will be Python >= 3.6. We test +NumPy against all these versions every time we merge code to master. Binary +installers may be available for a subset of these versions (see below). OS X ---- -OS X versions >= 10.9 are supported, for Python version support see `NEP 29`_. -We build binary wheels for OSX that are compatible with Python.org Python, -system Python, homebrew and macports - see this `OSX wheel building summary +OS X versions >= 10.9 are supported, for Python version support see +:doc:`NEP 29<neps:nep-0029-deprecation_policy>`. We build binary wheels for +OSX that are compatible with Python.org Python, system Python, homebrew and +macports - see this `OSX wheel building summary <https://github.com/MacPython/wiki/wiki/Spinning-wheels>`_ for details. @@ -95,7 +96,6 @@ You will need Cython for building the binaries. Cython compiles the ``.pyx`` files in the NumPy distribution to ``.c`` files. .. _mingw-w64 toolchain : https://mingwpy.github.io -.. _NEP 29 : https://numpy.org/neps/nep-0029-deprecation_policy.html OpenBLAS ------------ diff --git a/doc/source/conf.py b/doc/source/conf.py index d6a0f8bf3..65dcae245 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -240,11 +240,12 @@ texinfo_documents = [ # Intersphinx configuration # ----------------------------------------------------------------------------- intersphinx_mapping = { + 'neps': ('https://numpy.org/neps', None), 'python': ('https://docs.python.org/dev', None), 'scipy': ('https://docs.scipy.org/doc/scipy/reference', None), 'matplotlib': ('https://matplotlib.org', None), 'imageio': ('https://imageio.readthedocs.io/en/stable', None), - 'skimage': ('https://scikit-image.org/docs/stable', None) + 'skimage': ('https://scikit-image.org/docs/stable', None), } diff --git a/doc/source/dev/howto-docs.rst b/doc/source/dev/howto-docs.rst index 0e2e03e0b..d9955ddae 100644 --- a/doc/source/dev/howto-docs.rst +++ b/doc/source/dev/howto-docs.rst @@ -35,8 +35,9 @@ Current vision for the documentation: NEP 44 -------------------------------------------- Recently, the NumPy community approved a *NumPy Enhancement Proposal (NEP)* -about documentation, `NEP 44 - Restructuring the NumPy Documentation -<https://www.numpy.org/neps/nep-0044-restructuring-numpy-docs>`__. +about documentation, +:doc:`NEP 44 - Restructuring the NumPy Documentation + <neps:nep-0044-restructuring-numpy-docs>`. **Where is the documentation?** @@ -87,7 +88,7 @@ check out the following specific guides: Major additions to the documentation (e.g. new tutorials) should be proposed to the `mailing list <https://mail.python.org/mailman/listinfo/numpy-discussion>`__. - + Other ways to contribute ------------------------ diff --git a/numpy/doc/dispatch.py b/numpy/doc/dispatch.py index ba76a43ae..af70ed836 100644 --- a/numpy/doc/dispatch.py +++ b/numpy/doc/dispatch.py @@ -267,5 +267,5 @@ Refer to the `dask source code <https://github.com/dask/dask>`_ and `cupy source code <https://github.com/cupy/cupy>`_ for more fully-worked examples of custom array containers. -See also `NEP 18 <http://www.numpy.org/neps/nep-0018-array-function-protocol.html>`_. +See also :doc:`NEP 18<neps:nep-0018-array-function-protocol>`. """ diff --git a/numpy/lib/format.py b/numpy/lib/format.py index 2afa4ac10..cb2d511af 100644 --- a/numpy/lib/format.py +++ b/numpy/lib/format.py @@ -156,8 +156,8 @@ names. Notes ----- The ``.npy`` format, including motivation for creating it and a comparison of -alternatives, is described in the `"npy-format" NEP -<https://www.numpy.org/neps/nep-0001-npy-format.html>`_, however details have +alternatives, is described in the +:doc:`"npy-format" NEP <neps:nep-0001-npy-format>`, however details have evolved with time and this document is more current. """ |