pylint-dev · Pierre-Sassoulas · Feb 7, 2022 · Jan 29, 2022 · Jan 29, 2022 · Jan 29, 2022
diff --git a/doc/exts/pylint_messages.py b/doc/exts/pylint_messages.py
@@ -122,7 +122,10 @@ def _write_messages_list_page(
         stream.write(
             f""".. _messages-list:
 
-{get_rst_title("Pylint Messages", "=")}
+.. NOTE: This file is auto-generated. Make any changes to the associated
+.. docs extension in '{__name__}.py'.
+
+{get_rst_title("Overview of all Pylint messages", "=")}
 Pylint can emit the following messages:
 
 """

diff --git a/doc/messages/messages_introduction.rst b/doc/messages/messages_introduction.rst
@@ -1,7 +1,7 @@
 .. _messages-introduction:
 
-Pylint messages
-================
+Message categories
+=====================
 
 Pylint can emit various messages. These are categorized according to categories::
 

diff --git a/doc/messages/messages_list.rst b/doc/messages/messages_list.rst
@@ -1,7 +1,10 @@
 .. _messages-list:
 
-Pylint Messages
-===============
+.. NOTE: This file is auto-generated. Make any changes to the associated
+.. docs extension in 'pylint_messages.py'.
+
+Overview of all Pylint messages
+=================================
 
 Pylint can emit the following messages:
 

diff --git a/doc/release.md b/doc/release.md
@@ -6,7 +6,7 @@ So, you want to release the `X.Y.Z` version of pylint ?
 
 1. Check if the dependencies of the package are correct, make sure that astroid is
    pinned to the latest version.
-2. Install the release dependencies `pip3 install pre-commit tbump`
+2. Install the release dependencies `pip3 install pre-commit tbump tox`
 3. Bump the version by using `tbump X.Y.Z --no-tag --no-push`
 4. Check the result (Do `git diff vX.Y.Z-1 ChangeLog doc/whatsnew/` in particular).
 5. Move back to a dev version for pylint with `tbump`:

diff --git a/tbump.toml b/tbump.toml
@@ -28,6 +28,10 @@ src = "pylint/__pkginfo__.py"
 name = "Upgrade changelog"
 cmd = "python3 script/bump_changelog.py {new_version}"
 
+[[before_commit]]
+name = "Upgrade and check doc"
+cmd = "tox -e docs||echo 'Hack so this command does not fail'"
+
 [[before_commit]]
 name = "Upgrade copyrights"
 cmd = "pip3 install copyrite;copyrite --contribution-threshold 1 --change-threshold 3 --backend-type git --aliases=.copyrite_aliases . --jobs=8"