Prepare docs for release 25.9.0 (#4751)

* Prepare docs for release 25.9.0

* Remove unreleased changelog section

Author: MeGaGiGaGon

CHANGES.md

@@ -1,15 +1,14 @@
 # Change Log
 
-## Unreleased
+## 25.9.0
 
 ### Highlights
 
-<!-- Include any especially major or disruptive changes here -->
+- Remove support for pre-python 3.7 `await/async` as soft keywords/variable names
+  (#4676)
 
 ### Stable style
 
-<!-- Changes that affect Black's stable style -->
-
 - Fix crash while formatting a long `del` statement containing tuples (#4628)
 - Fix crash while formatting expressions using the walrus operator in complex `with`
   statements (#4630)
@@ -19,16 +18,12 @@
 - Fix crash when formatting a `\` followed by a `\r` followed by a comment (#4663)
 - Fix crash on a `\\r\n` (#4673)
 - Fix crash on `await ...` (where `...` is a literal `Ellipsis`) (#4676)
-- Remove support for pre-python 3.7 `await/async` as soft keywords/variable names
-  (#4676)
 - Fix crash on parenthesized expression inside a type parameter bound (#4684)
 - Fix crash when using line ranges excluding indented single line decorated items
   (#4670)
 
 ### Preview style
 
-<!-- Changes that affect Black's preview style -->
-
 - Fix a bug where one-liner functions/conditionals marked with `# fmt: skip` would still
   be formatted (#4552)
 - Improve `multiline_string_handling` with ternaries and dictionaries (#4657)
@@ -40,50 +35,25 @@
 - Add `\r` style newlines to the potential newlines to normalize file newlines both from
   and to (#4710)
 
-### 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 -->
-
 - Rewrite tokenizer to improve performance and compliance (#4536)
 - Fix bug where certain unusual expressions (e.g., lambdas) were not accepted in type
   parameter bounds and defaults. (#4602)
 
 ### Performance
 
-<!-- Changes that improve Black's performance. -->
-
 - Avoid using an extra process when running with only one worker (#4734)
 
-### Output
-
-<!-- Changes to Black's terminal output and error messages -->
-
-### _Blackd_
-
-<!-- Changes to blackd -->
-
 ### Integrations
 
-<!-- For example, Docker, GitHub Actions, pre-commit, editors -->
-
 - Fix the version check in the vim file to reject Python 3.8 (#4567)
 - Enhance GitHub Action `psf/black` to read Black version from an additional section in
   pyproject.toml: `[project.dependency-groups]` (#4606)
 - Build gallery docker image with python3-slim and reduce image size (#4686)
 
 ### Documentation
 
-<!-- Major changes to documentation and policies. Small docs changes
-     don't need a changelog entry. -->
-
 - Add FAQ entry for windows emoji not displaying (#4714)
 
 ## 25.1.0

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.1.0
+    rev: 25.9.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.1.0
+    rev: 25.9.0
     hooks:
       - id: black-jupyter
         # It is recommended to specify the latest version of Python

docs/usage_and_configuration/the_basics.md

@@ -270,8 +270,8 @@ configuration file for consistent results across environments.
 
 ```console
 $ black --version
-black, 25.1.0 (compiled: yes)
-$ black --required-version 25.1.0 -c "format = 'this'"
+black, 25.9.0 (compiled: yes)
+$ black --required-version 25.9.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!
@@ -372,7 +372,7 @@ You can check the version of _Black_ you have installed using the `--version` fl
 
 ```console
 $ black --version
-black, 25.1.0
+black, 25.9.0
 ```
 
 #### `--config`