[doc] Add a check for changelogs and fix the issues encountered

Author: Pierre-Sassoulas

.pre-commit-config.yaml

@@ -74,6 +74,14 @@ repos:
         args: ["-rn", "-sn", "--rcfile=pylintrc", "--fail-on=I", "--spelling-dict=en"]
         exclude: tests/functional/|tests/input|tests(/\w*)*data/|doc/
         stages: [manual]
+      - id: check-changelog
+        alias: check-changelog
+        name: check-changelog
+        types: [text]
+        args: ["--verbose"]
+        entry: python3 script/check_changelog.py
+        pass_filenames: false
+        language: system
       - id: fix-documentation
         name: Fix documentation
         entry: python3 -m script.fix_documentation

doc/development_guide/contributor_guide/tests/install.rst

@@ -25,7 +25,7 @@ This ensures your testing environment is similar to Pylint's testing environment
 
 **Optionally** (Because there's an auto-fix if you open a merge request): We have
 pre-commit hooks which should take care of the autoformatting for you before each
-commits. To enable it, run ``pre-commit install`` in the ``pylint`` root directory.
+commit. To enable it, run ``pre-commit install`` in the ``pylint`` root directory.
 
 Astroid installation
 --------------------

doc/whatsnew/0/0.x.rst

@@ -658,7 +658,7 @@ Release date: 2006-08-10
 * started a reference user manual
 
 * new W0212 message for access to protected member from client code
-  (close #14081)
+  (Closes #14081)
 
 * new W0105 and W0106 messages extracted from W0104 (statement seems
   to have no effect) respectively when the statement is actually string
@@ -668,7 +668,7 @@ Release date: 2006-08-10
 * reclassified W0302 to C0302
 
 * fix so that global messages are not anymore connected to the last
-  analyzed module (close #10106)
+  analyzed module (Closes #10106)
 
 * fix some bugs related to local disabling of messages
 
@@ -708,7 +708,7 @@ Release date: 2006-03-06
 
 * W0705 has been reclassified to E0701, and is now detecting more
   inheriting problem, and a false positive when empty except clause is
-  following an Exception catch has been fixed (close #10422)
+  following an Exception catch has been fixed (Closes #10422)
 
 * E0212 and E0214 (metaclass/class method should have mcs/cls as first
   argument have been reclassified to C0202 and C0203 since this not as
@@ -812,13 +812,13 @@ Release date: 2005-11-07
   module whose name starts with a deprecated module's name (close
   #10061)
 
-* fix "module has no name __dict__" false positive (close #10039)
+* fix "module has no name __dict__" false positive (Closes #10039)
 
 * fix "access to undefined variable __path__" false positive (close
   #10065)
 
 * fix "explicit return in __init__" false positive when return is
-  actually in an inner function (close #10075)
+  actually in an inner function (Closes #10075)
 
 
 What's New in Pylint 0.8.0?
@@ -835,7 +835,7 @@ Release date: 2005-10-21
 
 * new --acquired-members option on the classes checker, used when
   --zope=yes to avoid false positive on acquired attributes (listed
-  using this new option) (close #8616)
+  using this new option) (Closes #8616)
 
 * generate one E0602 for each use of an undefined variable
   (previously, only one for the first use but not for the following)
@@ -855,11 +855,11 @@ Release date: 2005-10-21
 * fix astng checkers traversal order
 
 * fix bug in format checker when parsing a file from a platform
-  using different new line characters (close #9239)
+  using different new line characters (Closes #9239)
 
 * fix encoding detection regexp
 
-* fix --rcfile handling (support for --rcfile=file, close #9590)
+* fix --rcfile handling (support for --rcfile=file, Closes #9590)
 
 
 What's New in Pylint 0.7.0?
@@ -896,11 +896,11 @@ Release date: 2005-04-14
 * don't fail if we are unable to read an inline option  (e.g. inside a
   module), just produce an information message (test func_i0010)
 
-* new message E0103 for break or continue outside loop (close #8883,
+* new message E0103 for break or continue outside loop (Closes #8883,
   test func_continue_not_in_loop)
 
 * fix bug in the variables checker, causing non detection of some
-  actual name error (close #8884, test
+  actual name error (Closes #8884, test
   func_nameerror_on_string_substitution)
 
 * fix bug in the classes checker which was making pylint crash if
@@ -980,7 +980,7 @@ Release date: 2005-01-20
 * correctly detect access to member defined latter in __init__ method
 
 * now depends on common 0.8.1 to fix problem with interface resolution
-  (close #8606)
+  (Closes #8606)
 
 * new --list-msgs option describing available checkers and their
   messages

doc/whatsnew/1/1.3.rst

@@ -5,23 +5,32 @@
 Release date: 2014-07-26
 
 * Allow hanging continued indentation for implicitly concatenated
-  strings. Closes issue #232.
+  strings.
+
+  Closes #232.
 
 * Pylint works under Python 2.5 again, and its test suite passes.
 
 * Fix some false positives for the cellvar-from-loop warnings.
-  Closes issue #233.
+
+  Closes #233.
 
 * Return new astroid class nodes when the inferencer can detect that
   that result of a function invocation on a type (like ``type`` or
-  `abc.ABCMeta`) is requested. Closes #205.
+  `abc.ABCMeta`) is requested.
+
+  Closes #205.
 
 * Emit 'undefined-variable' for undefined names when using the
   Python 3 ``metaclass=`` argument.
 
-* Checkers respect priority now. Close issue #229.
+* Checkers respect priority now.
+
+  Closes #229
+
+* Fix a false positive regarding W0511.
 
-* Fix a false positive regarding W0511. Closes issue #149.
+  Closes #149.
 
 * Fix unused-import false positive with Python 3 metaclasses (#143).
 
@@ -37,12 +46,18 @@ Release date: 2014-07-26
   of except handlers is different than 1. Fixes issue #113.
 
 * Issue attribute-defined-outside-init for all cases, not just
-  for the last assignment. Closes issue #262.
+  for the last assignment.
 
-* Emit 'not-callable' when calling properties. Closes issue #268.
+  Closes #262.
+
+* Emit 'not-callable' when calling properties.
+
+  Closes #268.
 
 * Fix a false positive with unbalanced iterable unpacking,
-  when encountering starred nodes. Closes issue #273.
+  when encountering starred nodes.
+
+  Closes #273.
 
 * Add new checks, 'invalid-slice-index' and 'invalid-sequence-index'
   for invalid sequence and slice indices.
@@ -51,25 +66,35 @@ Release date: 2014-07-26
   attributes not defined in slots.
 
 * Don't emit 'no-name-in-module' for ignored modules.
-  Closes issue #223.
+
+  Closes #223.
 
 * Fix an 'unused-variable' false positive, where the variable is
-  assigned through an import. Closes issue #196.
+  assigned through an import.
+
+  Closes #196.
 
 * Definition order is considered for classes, function arguments
-  and annotations. Closes issue #257.
+  and annotations.
+
+  Closes #257.
 
 * Don't emit 'unused-variable' when assigning to a nonlocal.
-  Closes issue #275.
+
+  Closes #275.
 
 * Do not let ImportError propagate from the import checker, leading to crash
-  in some namespace package related cases. Closes issue #203.
+  in some namespace package related cases.
+
+  Closes #203.
 
 * Don't emit 'pointless-string-statement' for attribute docstrings.
-  Closes issue #193.
+
+  Closes #193.
 
 * Use the proper mode for pickle when opening and writing the stats file.
-  Closes issue #148.
+
+  Closes #148.
 
 * Don't emit hidden-method message when the attribute has been
   monkey-patched, you're on your own when you do that.
@@ -78,7 +103,10 @@ Release date: 2014-07-26
   module as the offended class, avoiding to mangle the output in some cases.
 
 * Don't emit 'unnecessary-lambda' if the body of the lambda call contains
-  call chaining. Closes issue #243.
+  call chaining.
+
+  Closes #243.
 
 * Don't emit 'missing-docstring' when the actual docstring uses ``.format``.
-  Closes issue #281.
+
+  Closes #281.