[script] Add :ref: automatically in the documentation

.pre-commit-config.yaml

@@ -122,6 +122,17 @@ repos:
         types: [text]
         files: ^(doc/whatsnew/fragments)
         exclude: doc/whatsnew/fragments/_.*.rst
+      - id: check-message-references
+        name: Check pylint message references
+        entry: python script/check_message_references.py
+        language: system
+        args: ["--fix"]
+        types_or: [python, rst, markdown, text]
+        files: ^doc/(whatsnew|data/messages)/.*\.rst$
+        exclude:
+          \.( doc/development_guide/api/pylint.rst|
+          doc/development_guide/how_tos/custom_checkers.rst| )$
+        pass_filenames: true
   - repo: https://github.com/rstcheck/rstcheck
     rev: "v6.2.5"
     hooks:

doc/data/messages/u/useless-parent-delegation/related.rst

@@ -1 +1 @@
-- `Stackoverflow explanation for 'useless-super-delegation' <https://stackoverflow.com/a/51030674/2519059>`_
+- `Stackoverflow explanation for ':ref:`useless-super-delegation`' <https://stackoverflow.com/a/51030674/2519059>`_

doc/whatsnew/1/1.6/summary.rst

@@ -83,7 +83,7 @@ New features
   contains more forward-looking functions::
 
       $ cat a.py
-      # Oups, now pylint emits a redefined-builtin message.
+      # Oups, now pylint emits a :ref:`redefined-builtin` message.
       from six.moves import open
       $ pylint a.py --redefining-builtins-modules=six.moves
 
@@ -120,9 +120,9 @@ Other Changes
   This allows having comments inside list values, in the configuration,
   such as::
 
-      disable=no-member,
+      disable=:ref:`no-member`,
               # Don't like this check
-              bad-indentation
+              :ref:`bad-indentation`
 
 * We now use the isort_ package internally.
 

doc/whatsnew/1/1.7/summary.rst

@@ -696,15 +696,15 @@ Other Changes
   For instance, you can now use the **#** sign for having comments inside
   comma separated values, as seen below::
 
-      disable=no-member, # Don't care about it for now
-              bad-indentation, # No need for this
-              import-error
+      disable=:ref:`no-member`, # Don't care about it for now
+              :ref:`bad-indentation`, # No need for this
+              :ref:`import-error`
 
   Of course, interweaving comments with values is also working::
 
-      disable=no-member,
+      disable=:ref:`no-member`,
               # Don't care about it for now
-              bad-indentation # No need for this
+              :ref:`bad-indentation` # No need for this
 
 
   This works by setting the `inline comment prefixes`_ accordingly.

doc/whatsnew/2/2.5/full.rst

@@ -24,8 +24,8 @@ Release date: 2020-06-8
 * In a TOML configuration file, it's now possible to use rich (non-string) types, such as list, integer or boolean instead of strings. For example, one can now define a *list* of message identifiers to enable like this::
 
     enable = [
-        "use-symbolic-message-instead",
-        "useless-suppression",
+        ":ref:`use-symbolic-message-instead`",
+        ":ref:`useless-suppression`",
     ]
 
   Closes #3538

doc/whatsnew/4/4.0/index.rst

@@ -285,7 +285,7 @@ False Negatives Fixed
 
   Closes #9770 (`#9770 <https://github.com/pylint-dev/pylint/issues/9770>`_)
 
-- Fix false negative where function-redefined (E0102) was not reported for functions with a leading underscore.
+- Fix false negative where :ref:`function-redefined` (E0102) was not reported for functions with a leading underscore.
 
   Closes #9894 (`#9894 <https://github.com/pylint-dev/pylint/issues/9894>`_)
 
@@ -327,7 +327,7 @@ Other Bug Fixes
 
   Closes #8736. (`#8736 <https://github.com/pylint-dev/pylint/issues/8736>`_)
 
-- Fixed unidiomatic-typecheck only checking left-hand side.
+- Fixed :ref:`unidiomatic-typecheck` only checking left-hand side.
 
   Closes #10217 (`#10217 <https://github.com/pylint-dev/pylint/issues/10217>`_)