Use :doc: instead of :ref: to refer to pages...

...Also, use :pr: role in some recent changelog entries
marshmallow-code · Jul 14, 2018 · ee5ee8c · ee5ee8c
1 parent a721931
commit ee5ee8c
Show file tree

Hide file tree

Showing 5 changed files with 11 additions and 17 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -13,19 +13,19 @@ Bug fixes:
 
 Other changes:
 
-* *Backwards-incompatible*: Drop support for Python 3.4 (:issue:`243`). Python 2.7 and
+* *Backwards-incompatible*: Drop support for Python 3.4 (:pr:`243`). Python 2.7 and
   >=3.5 are supported.
 * *Backwards-incompatible*: Drop support for marshmallow<2.15.0.
   marshmallow>=2.15.0 and >=3.0.0b12 are officially supported.
 * Use `black <https://github.com/ambv/black>`_ with `pre-commit <https://pre-commit.com/>`_
-  for code formatting.
+  for code formatting (:pr:`244`).
 
 3.0.2 (2018-07-05)
 ******************
 
 Bug fixes:
 
-* Fix compatibility with marshmallow 3.0.0b12 (:issue:`242`). Thanks :user:`lafrech`.
+* Fix compatibility with marshmallow 3.0.0b12 (:pr:`242`). Thanks :user:`lafrech`.
 
 3.0.1 (2018-06-06)
 ******************
@@ -64,7 +64,7 @@ Changes:
 * *Backwards-incompatible*: Remove unused ``instance`` and ``kwargs`` arguments of ``argmap2schema``.
 * *Backwards-incompatible*: Remove ``Parser.load`` method (``Parser`` now calls ``Schema.load`` directly).
 
-These changes shouldn't affect most users. However, they might break custom parsers calling these methods. (:issue:`222`)
+These changes shouldn't affect most users. However, they might break custom parsers calling these methods. (:pr:`222`)
 
 * Drop support for aiohttp<3.0.0.
 
@@ -90,7 +90,7 @@ Changes:
 
 Features:
 
-* Add support for marshmallow>=3.0.0b7 (:issue:`188`). Thanks
+* Add support for marshmallow>=3.0.0b7 (:pr:`188`). Thanks
   :user:`lafrech`.
 
 Deprecations:
@@ -104,7 +104,7 @@ Changes:
 
 * ``HTTPExceptions`` raised with `webargs.flaskparser.abort` will always
   have the ``data`` attribute, even if no additional keywords arguments
-  are passed (:issue:`184`). Thanks :user:`lafrech`.
+  are passed (:pr:`184`). Thanks :user:`lafrech`.
 
 Support:
 

diff --git a/docs/advanced.rst b/docs/advanced.rst
@@ -1,5 +1,3 @@
-.. _advanced:
-
 Advanced Usage
 ==============
 
@@ -364,5 +362,5 @@ To reduce boilerplate, you could create shortcuts, like so:
 Next Steps
 ----------
 
-- See the :ref:`Framework Support <frameworks>` page for framework-specific guides.
+- See the :doc:`Framework Support <framework_support>` page for framework-specific guides.
 - For example applications, check out the `examples <https://github.com/sloria/webargs/tree/dev/examples>`_ directory.
diff --git a/docs/changelog.rst b/docs/changelog.rst
@@ -1,3 +1 @@
-.. _changelog:
-
 .. include:: ../CHANGELOG.rst
diff --git a/docs/index.rst b/docs/index.rst
@@ -9,7 +9,7 @@ webargs
     A friendly library for parsing HTTP request arguments.
 
 
-Release v\ |version|. (:ref:`Changelog <changelog>`)
+Release v\ |version|. (:doc:`Changelog <changelog>`)
 
 webargs is a Python library for parsing HTTP request arguments, with built-in support for popular web frameworks, including Flask, Django, Bottle, Tornado, Pyramid, webapp2, Falcon, and aiohttp.
 
@@ -81,7 +81,7 @@ Get It Now
 
     pip install -U webargs
 
-Ready to get started? Go on to the :ref:`Quickstart tutorial <quickstart>` or check out some `examples <https://github.com/sloria/webargs/tree/dev/examples>`_.
+Ready to get started? Go on to the :doc:`Quickstart tutorial <quickstart>` or check out some `examples <https://github.com/sloria/webargs/tree/dev/examples>`_.
 
 User Guide
 ----------

diff --git a/docs/quickstart.rst b/docs/quickstart.rst
@@ -1,5 +1,3 @@
-.. _quickstart:
-
 Quickstart
 ==========
 
@@ -227,6 +225,6 @@ Nesting Fields
 Next Steps
 ----------
 
-- Go on to :ref:`Advanced Usage <advanced>` to learn how to add custom location handlers, use marshmallow Schemas, and more.
-- See the :ref:`Framework Support <frameworks>` page for framework-specific guides.
+- Go on to :doc:`Advanced Usage <advanced>` to learn how to add custom location handlers, use marshmallow Schemas, and more.
+- See the :doc:`Framework Support <framework_support>` page for framework-specific guides.
 - For example applications, check out the `examples <https://github.com/sloria/webargs/tree/dev/examples>`_ directory.