pypa · jaraco · Feb 4, 2022 · Feb 3, 2022 · Feb 3, 2022
diff --git a/CHANGES.rst b/CHANGES.rst
@@ -30,6 +30,18 @@ Changes
 * #3057: Don't include optional ``Home-page`` in metadata if no ``url`` is specified. -- by :user:`cdce8p`
 * #3062: Merge with pypa/distutils@b53a824ec3 including improved support for lib directories on non-x64 Windows builds.
 
+Documentation changes
+^^^^^^^^^^^^^^^^^^^^^
+* #2897: Added documentation about wrapping ``setuptools.build_meta`` in a in-tree
+  custom backend. This is a :pep:`517`-compliant way of dynamically specifying
+  build dependencies (e.g. when platform, OS and other markers are not enough).
+  -- by :user:`abravalheri`
+* #3034: Replaced occurrences of the defunct distutils-sig mailing list with pointers
+  to GitHub Discussions.
+  -- by :user:`ashemedai`
+* #3056: The documentation has stopped suggesting to add ``wheel`` to
+  :pep:`517` requirements -- by :user:`webknjaz`
+
 Misc
 ^^^^
 * #3054: Used Py3 syntax ``super().__init__()`` -- by :user:`imba-tjd`

diff --git a/changelog.d/2897.docs.rst b/changelog.d/2897.docs.rst
diff --git a/changelog.d/3034.docs.rst b/changelog.d/3034.docs.rst
diff --git a/changelog.d/3056.docs.rst b/changelog.d/3056.docs.rst
diff --git a/tools/finalize.py b/tools/finalize.py
@@ -79,11 +79,18 @@ def check_changes():
     """
     allowed = 'deprecation', 'breaking', 'change', 'doc', 'misc'
     except_ = 'README.rst', '.gitignore'
-    assert all(
-        any(key in file.name for key in allowed)
+    news_fragments = (
+        file
         for file in pathlib.Path('changelog.d').iterdir()
         if file.name not in except_
     )
+    unrecognized = [
+        str(file)
+        for file in news_fragments
+        if not any(f".{key}" in file.suffixes for key in allowed)
+    ]
+    if unrecognized:
+        raise ValueError(f"Some news fragments have invalid names: {unrecognized}")
 
 
 if __name__ == '__main__':