Prepare 25.12.0 release (#4891)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: cobaltt7

CHANGES.md

@@ -1,20 +1,13 @@
 # Change Log
 
-## Unreleased
-
-<!-- PR authors:
-     Please include the PR number in the changelog entry, not the issue number -->
+## 25.12.0
 
 ### Highlights
 
-<!-- Include any especially major or disruptive changes here -->
-
 - Black no longer supports running with Python 3.9 (#4842)
 
 ### Stable style
 
-<!-- Changes that affect Black's stable style -->
-
 - Fix bug where comments preceding `# fmt: off`/`# fmt: on` blocks were incorrectly
   removed, particularly affecting Jupytext's `# %% [markdown]` comments (#4845)
 - Fix crash when multiple `# fmt: skip` comments are used in a multi-part if-clause, on
@@ -23,47 +16,25 @@
 
 ### Preview style
 
-<!-- Changes that affect Black's preview style -->
-
 - Fix `fmt: skip` skipping the line after instead of the line it's on (#4855)
 - Remove unnecessary parentheses from the left-hand side of assignments while preserving
   magic trailing commas and intentional multiline formatting (#4865)
 - Fix `fix_fmt_skip_in_one_liners` crashing on `with` statements (#4853)
 - Fix `fix_fmt_skip_in_one_liners` crashing on annotated parameters (#4854)
 - Fix `# fmt: skip` behavior for deeply nested expressions (#4883)
 
-### Configuration
-
-<!-- Changes to how Black can be configured -->
-
 ### Packaging
 
 <!-- Changes to how Black is packaged, such as dependency requirements -->
 
-### Parser
-
-<!-- Changes to the parser or to version autodetection -->
-
-### Performance
-
-<!-- Changes that improve Black's performance. -->
-
-### Output
-
-<!-- Changes to Black's terminal output and error messages -->
-
-### _Blackd_
-
-<!-- Changes to blackd -->
+- Releases now include arm64 Windows binaries and wheels (#4814)
 
 ### Integrations
 
 <!-- For example, Docker, GitHub Actions, pre-commit, editors -->
 
-### Documentation
-
-<!-- Major changes to documentation and policies. Small docs changes
-     don't need a changelog entry. -->
+- Add `output-file` input to GitHub Action `psf/black` to write formatter output to a
+  file for artifact capture and log cleanliness (#4824)
 
 ## 25.11.0
 
@@ -95,7 +66,6 @@
 ### Packaging
 
 - Releases now include arm64 Linux binaries (#4773)
-- Releases now include arm64 Windows binaries and wheels (#4814)
 
 ### Output
 
@@ -112,8 +82,6 @@
 - Enable 3.14 base CI (#4804)
 - Enhance GitHub Action `psf/black` to support the `required-version` major-version-only
   "stability" format when using pyproject.toml (#4770)
-- Add `output-file` input to GitHub Action `psf/black` to write formatter output to a
-  file for artifact capture and log cleanliness (#4824)
 - Improve error message for vim plugin users. It now handles independently vim version
 - Vim: Warn on unsupported Vim and Python versions independently (#4772)
 - Vim: Print the import paths when importing black fails (#4675)

docs/contributing/release_process.md

@@ -44,15 +44,15 @@ To cut a release:
      - So unless there already has been a release during this month, `N` should be `0`
    - Example: the first release in January, 2022 → `22.1.0`
    - `release.py` will calculate this and log to stderr for you copy paste pleasure
+1. Double-check that no changelog entries since the last release were put in the wrong
+   section (e.g., run `git diff origin/stable CHANGES.md`)
 1. File a PR editing `CHANGES.md` and the docs to version the latest changes
    - Run `python3 scripts/release.py [--debug]` to generate most changes
 1. If `release.py` fails manually edit; otherwise, yay, skip this step!
    1. Replace the `## Unreleased` header with the version number
    1. Remove any empty sections for the current release
    1. (_optional_) Read through and copy-edit the changelog (eg. by moving entries,
       fixing typos, or rephrasing entries)
-   1. Double-check that no changelog entries since the last release were put in the
-      wrong section (e.g., run `git diff origin/stable CHANGES.md`)
    1. Update references to the latest version in
       {doc}`/integrations/source_version_control` and
       {doc}`/usage_and_configuration/the_basics`

docs/integrations/source_version_control.md

@@ -8,7 +8,7 @@ Use [pre-commit](https://pre-commit.com/). Once you
 repos:
   # Using this mirror lets us use mypyc-compiled black, which is about 2x faster
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.11.0
+    rev: 25.12.0
     hooks:
       - id: black
         # It is recommended to specify the latest version of Python
@@ -35,7 +35,7 @@ include Jupyter Notebooks. To use this hook, simply replace the hook's `id: blac
 repos:
   # Using this mirror lets us use mypyc-compiled black, which is about 2x faster
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.11.0
+    rev: 25.12.0
     hooks:
       - id: black-jupyter
         # It is recommended to specify the latest version of Python

docs/usage_and_configuration/the_basics.md

@@ -278,8 +278,8 @@ configuration file for consistent results across environments.
 
 ```console
 $ black --version
-black, 25.11.0 (compiled: yes)
-$ black --required-version 25.11.0 -c "format = 'this'"
+black, 25.12.0 (compiled: yes)
+$ black --required-version 25.12.0 -c "format = 'this'"
 format = "this"
 $ black --required-version 31.5b2 -c "still = 'beta?!'"
 Oh no! 💥 💔 💥 The required version does not match the running version!
@@ -380,7 +380,7 @@ You can check the version of _Black_ you have installed using the `--version` fl
 
 ```console
 $ black --version
-black, 25.11.0
+black, 25.12.0
 ```
 
 #### `--config`