pylint-dev · Pierre-Sassoulas · Oct 2, 2023 · Oct 2, 2023 · Oct 2, 2023
diff --git a/doc/development_guide/contributor_guide/release.rst b/doc/development_guide/contributor_guide/release.rst
@@ -19,9 +19,6 @@ patch release first. See ``Releasing a patch version``.**
    ``tbump 2.4.0 --no-push --no-tag``)
 -  Check the commit created with ``git show`` amend the commit if
    required.
--  Create a new ``What's new in Pylint X.Y+1`` document. Add it to
-   ``doc/index.rst``. Take a look at the examples from ``doc/whatsnew``.
-   Commit that with ``git commit -am "wip"``.
 -  Move the ``main`` branch up to a dev version with ``tbump``:
 
 .. code:: bash
@@ -36,11 +33,12 @@ For example:
    tbump 2.5.0-dev0 --no-tag --no-push
    git commit -am "Upgrade the version to 2.5.0-dev0 following 2.4.0 release"
 
-Check the commit, fixup the ‘wip’ commit with the what’s new then push
-to a release branch
-
--  Open a merge request with the two commits (no one can push directly
-   on ``main``)
+-  tbump will have created a new ``What's new in Pylint X.Y+1`` document.
+   Add it to ``doc/whatsnew/3/index.rst``. Take a look at the examples from ``doc/whatsnew``.
+   Commit that with ``git commit -a --amend``.
+- Push to a release branch
+- Open a merge request with the two commits (no one can push directly
+  on ``main``)
 -  After the merge, recover the merged commits on ``main`` and tag the
    first one (the version should be ``X.Y.Z``) as ``vX.Y.Z`` (For
    example: ``v2.4.0``)

diff --git a/doc/whatsnew/3/3.0/index.rst b/doc/whatsnew/3/3.0/index.rst
diff --git a/doc/whatsnew/3/3.1/index.rst b/doc/whatsnew/3/3.1/index.rst
@@ -0,0 +1,16 @@
+
+***************************
+ What's New in Pylint 3.1
+***************************
+
+.. toctree::
+   :maxdepth: 2
+
+:Release:3.1
+:Date: TBA
+
+Summary -- Release highlights
+=============================
+
+
+.. towncrier release notes start
diff --git a/doc/whatsnew/3/index.rst b/doc/whatsnew/3/index.rst
@@ -6,4 +6,5 @@ This is the full list of change in pylint 3.x minors, by categories.
 .. toctree::
    :maxdepth: 2
 
+   3.1/index
    3.0/index
diff --git a/doc/whatsnew/fragments/1144.false_negative b/doc/whatsnew/fragments/1144.false_negative
diff --git a/doc/whatsnew/fragments/1954.performance b/doc/whatsnew/fragments/1954.performance
diff --git a/doc/whatsnew/fragments/2018.user_action b/doc/whatsnew/fragments/2018.user_action
diff --git a/doc/whatsnew/fragments/3613.false_positive b/doc/whatsnew/fragments/3613.false_positive
diff --git a/doc/whatsnew/fragments/3670.false_positive b/doc/whatsnew/fragments/3670.false_positive
diff --git a/doc/whatsnew/fragments/3696.breaking b/doc/whatsnew/fragments/3696.breaking
diff --git a/doc/whatsnew/fragments/374.bugfix b/doc/whatsnew/fragments/374.bugfix
diff --git a/doc/whatsnew/fragments/4171.bugfix b/doc/whatsnew/fragments/4171.bugfix
diff --git a/doc/whatsnew/fragments/4741.feature b/doc/whatsnew/fragments/4741.feature
diff --git a/doc/whatsnew/fragments/4874.bugfix b/doc/whatsnew/fragments/4874.bugfix
diff --git a/doc/whatsnew/fragments/5159.new_check b/doc/whatsnew/fragments/5159.new_check
diff --git a/doc/whatsnew/fragments/529.performance b/doc/whatsnew/fragments/529.performance
diff --git a/doc/whatsnew/fragments/5488.other b/doc/whatsnew/fragments/5488.other
diff --git a/doc/whatsnew/fragments/6287.bugfix b/doc/whatsnew/fragments/6287.bugfix
diff --git a/doc/whatsnew/fragments/6306.breaking b/doc/whatsnew/fragments/6306.breaking
diff --git a/doc/whatsnew/fragments/6871.user_action b/doc/whatsnew/fragments/6871.user_action
diff --git a/doc/whatsnew/fragments/7163.other b/doc/whatsnew/fragments/7163.other
diff --git a/doc/whatsnew/fragments/7229.bugfix b/doc/whatsnew/fragments/7229.bugfix
diff --git a/doc/whatsnew/fragments/7402.false_positive b/doc/whatsnew/fragments/7402.false_positive
diff --git a/doc/whatsnew/fragments/7506.false_positive b/doc/whatsnew/fragments/7506.false_positive
diff --git a/doc/whatsnew/fragments/7578.bugfix b/doc/whatsnew/fragments/7578.bugfix
diff --git a/doc/whatsnew/fragments/7710.bugfix b/doc/whatsnew/fragments/7710.bugfix
diff --git a/doc/whatsnew/fragments/7737.user_action b/doc/whatsnew/fragments/7737.user_action
diff --git a/doc/whatsnew/fragments/7761.false_negative b/doc/whatsnew/fragments/7761.false_negative
diff --git a/doc/whatsnew/fragments/7767.breaking b/doc/whatsnew/fragments/7767.breaking
diff --git a/doc/whatsnew/fragments/7767.false_positive b/doc/whatsnew/fragments/7767.false_positive
diff --git a/doc/whatsnew/fragments/7774.bugfix b/doc/whatsnew/fragments/7774.bugfix
diff --git a/doc/whatsnew/fragments/8112.feature b/doc/whatsnew/fragments/8112.feature
diff --git a/doc/whatsnew/fragments/8156.false_positive b/doc/whatsnew/fragments/8156.false_positive
diff --git a/doc/whatsnew/fragments/8167.false_positive b/doc/whatsnew/fragments/8167.false_positive
diff --git a/doc/whatsnew/fragments/8181.feature b/doc/whatsnew/fragments/8181.feature
diff --git a/doc/whatsnew/fragments/8189.bugfix b/doc/whatsnew/fragments/8189.bugfix
diff --git a/doc/whatsnew/fragments/8198.bugfix b/doc/whatsnew/fragments/8198.bugfix
diff --git a/doc/whatsnew/fragments/8251.breaking b/doc/whatsnew/fragments/8251.breaking
diff --git a/doc/whatsnew/fragments/8260.new_check b/doc/whatsnew/fragments/8260.new_check
diff --git a/doc/whatsnew/fragments/8361.bugfix b/doc/whatsnew/fragments/8361.bugfix
diff --git a/doc/whatsnew/fragments/8401.internal b/doc/whatsnew/fragments/8401.internal
diff --git a/doc/whatsnew/fragments/8403.false_positive b/doc/whatsnew/fragments/8403.false_positive
diff --git a/doc/whatsnew/fragments/8404.breaking b/doc/whatsnew/fragments/8404.breaking
diff --git a/doc/whatsnew/fragments/8404.internal b/doc/whatsnew/fragments/8404.internal
diff --git a/doc/whatsnew/fragments/8405.other b/doc/whatsnew/fragments/8405.other
diff --git a/doc/whatsnew/fragments/8407.internal b/doc/whatsnew/fragments/8407.internal
diff --git a/doc/whatsnew/fragments/8408.internal b/doc/whatsnew/fragments/8408.internal
diff --git a/doc/whatsnew/fragments/8409.internal b/doc/whatsnew/fragments/8409.internal
diff --git a/doc/whatsnew/fragments/8410.false_positive b/doc/whatsnew/fragments/8410.false_positive
diff --git a/doc/whatsnew/fragments/8411.user_action b/doc/whatsnew/fragments/8411.user_action
diff --git a/doc/whatsnew/fragments/8412.internal b/doc/whatsnew/fragments/8412.internal
diff --git a/doc/whatsnew/fragments/8416.breaking b/doc/whatsnew/fragments/8416.breaking
diff --git a/doc/whatsnew/fragments/8424.false_positive b/doc/whatsnew/fragments/8424.false_positive
diff --git a/doc/whatsnew/fragments/8434.bugfix b/doc/whatsnew/fragments/8434.bugfix
diff --git a/doc/whatsnew/fragments/8437.bugfix b/doc/whatsnew/fragments/8437.bugfix
diff --git a/doc/whatsnew/fragments/8453.bugfix b/doc/whatsnew/fragments/8453.bugfix
diff --git a/doc/whatsnew/fragments/8462.breaking b/doc/whatsnew/fragments/8462.breaking
diff --git a/doc/whatsnew/fragments/8463.internal b/doc/whatsnew/fragments/8463.internal
diff --git a/doc/whatsnew/fragments/8464.internal b/doc/whatsnew/fragments/8464.internal
diff --git a/doc/whatsnew/fragments/8465.user_action b/doc/whatsnew/fragments/8465.user_action