replace hardcoded urls to docs.pytest.org with internal crossrefs, add external crossrefs where possible

Signed-off-by: oleg.hoefling <oleg.hoefling@gmail.com>

doc/en/announce/release-2.1.0.rst

@@ -11,8 +11,8 @@ The single biggest news about this release are **perfected assertions**
 courtesy of Benjamin Peterson.  You can now safely use ``assert``
 statements in test modules without having to worry about side effects
 or python optimization ("-OO") options.  This is achieved by rewriting
-assert statements in test modules upon import, using a PEP302 hook.
+assert statements in test modules upon import, using a :pep:`302` hook.
-See https://docs.pytest.org/en/stable/how-to/assert.html for
+See :doc:`../how-to/assert` for
 detailed information.  The work has been partly sponsored by my company,
 merlinux GmbH.
 

doc/en/announce/release-3.0.0.rst

@@ -18,7 +18,7 @@ To see the complete changelog and documentation, please visit:
 
     http://docs.pytest.org
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.0.1.rst

@@ -8,7 +8,7 @@ drop-in replacement. To upgrade:
 
   pip install --upgrade pytest
 
-The changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.0.2.rst

@@ -8,7 +8,7 @@ drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.0.3.rst

@@ -8,7 +8,7 @@ being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.0.4.rst

@@ -8,7 +8,7 @@ being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.0.5.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.0.6.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 
 Thanks to all who contributed to this release, among them:

doc/en/announce/release-3.0.7.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.1.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-http://doc.pytest.org/en/stable/changelog.html
+:std:doc:`changelog`
 
 For complete documentation, please visit:
 
     http://docs.pytest.org
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.1.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.1.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.1.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.10.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.10.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.2.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    http://doc.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
     http://docs.pytest.org
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.2.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.2.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.2.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.2.4.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.2.5.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.3.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    http://doc.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
     http://docs.pytest.org
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.3.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.3.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.4.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    http://doc.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
     http://docs.pytest.org
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.4.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.4.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.5.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    http://doc.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
     http://docs.pytest.org
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.5.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.6.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    http://doc.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
     http://docs.pytest.org
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.6.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.6.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.6.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.6.4.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.7.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    http://doc.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
     http://docs.pytest.org
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.7.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.7.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.7.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at http://doc.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.7.4.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.8.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.8.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.8.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.9.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-3.9.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.9.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-3.9.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.0.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-4.0.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.0.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.1.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-4.1.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.2.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-4.2.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.3.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-4.3.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.4.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-4.4.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.4.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.5.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-4.6.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-4.6.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.6.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.6.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.6.4.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.6.5.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.6.6.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.6.7.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.6.8.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-4.6.9.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.0.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-5.0.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.1.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-5.1.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.1.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.1.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.2.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-5.2.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.2.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.2.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.2.4.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.3.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bugs fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from pypi via:
+As usual, you can upgrade from pypi via::
 
     pip install -U pytest
 

doc/en/announce/release-5.3.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.3.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.3.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.3.4.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.3.5.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.4.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bug fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from PyPI via:
+As usual, you can upgrade from PyPI via::
 
     pip install -U pytest
 

doc/en/announce/release-5.4.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.4.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-5.4.3.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-6.0.0.rst

@@ -9,13 +9,13 @@ against itself, passing on many different interpreters and platforms.
 This release contains a number of bug fixes and improvements, so users are encouraged
 to take a look at the CHANGELOG:
 
-    https://docs.pytest.org/en/latest/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/latest/
+    :std:doc:`../index`
 
-As usual, you can upgrade from PyPI via:
+As usual, you can upgrade from PyPI via::
 
     pip install -U pytest
 

doc/en/announce/release-6.0.0rc1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/latest/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-6.0.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/latest/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all who contributed to this release, among them:
 

doc/en/announce/release-6.0.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all of the contributors to this release:
 

doc/en/announce/release-6.1.0.rst

@@ -6,13 +6,13 @@ The pytest team is proud to announce the 6.1.0 release!
 This release contains new features, improvements, bug fixes, and breaking changes, so users
 are encouraged to take a look at the CHANGELOG carefully:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from PyPI via:
+As usual, you can upgrade from PyPI via::
 
     pip install -U pytest
 

doc/en/announce/release-6.1.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all of the contributors to this release:
 

doc/en/announce/release-6.1.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all of the contributors to this release:
 

doc/en/announce/release-6.2.0.rst

@@ -6,13 +6,13 @@ The pytest team is proud to announce the 6.2.0 release!
 This release contains new features, improvements, bug fixes, and breaking changes, so users
 are encouraged to take a look at the CHANGELOG carefully:
 
-    https://docs.pytest.org/en/stable/changelog.html
+    :std:doc:`changelog`
 
 For complete documentation, please visit:
 
-    https://docs.pytest.org/en/stable/
+    :std:doc:`../index`
 
-As usual, you can upgrade from PyPI via:
+As usual, you can upgrade from PyPI via::
 
     pip install -U pytest
 

doc/en/announce/release-6.2.1.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all of the contributors to this release:
 

doc/en/announce/release-6.2.2.rst

@@ -7,7 +7,7 @@ This is a bug-fix release, being a drop-in replacement. To upgrade::
 
   pip install --upgrade pytest
 
-The full changelog is available at https://docs.pytest.org/en/stable/changelog.html.
+The full changelog is available at :std:doc:`changelog`.
 
 Thanks to all of the contributors to this release: