Prepare release 23.9.0 (#3863)

Author: JelleZijlstra

CHANGES.md

@@ -14,14 +14,10 @@
 
 <!-- Changes that affect Black's preview style -->
 
-- More concise formatting for dummy implementations (#3796)
-
 ### Configuration
 
 <!-- Changes to how Black can be configured -->
 
-- Black now applies exclusion and ignore logic before resolving symlinks (#3846)
-
 ### Packaging
 
 <!-- Changes to how Black is packaged, such as dependency requirements -->
@@ -34,9 +30,6 @@
 
 <!-- Changes that improve Black's performance. -->
 
-- Avoid importing `IPython` if notebook cells do not contain magics (#3782)
-- Improve caching by comparing file hashes as fallback for mtime and size. (#3821)
-
 ### Output
 
 <!-- Changes to Black's terminal output and error messages -->
@@ -45,23 +38,45 @@
 
 <!-- Changes to blackd -->
 
-- Fix an issue in `blackd` with single character input (#3558)
-
 ### 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. -->
+
+## 23.9.0
+
+### Preview style
+
+- More concise formatting for dummy implementations (#3796)
+- In stub files, add a blank line between a statement with a body (e.g an
+  `if sys.version_info > (3, x):`) and a function definition on the same level (#3862)
+- Fix a bug whereby spaces were removed from walrus operators within subscript(#3823)
+
+### Configuration
+
+- Black now applies exclusion and ignore logic before resolving symlinks (#3846)
+
+### Performance
+
+- Avoid importing `IPython` if notebook cells do not contain magics (#3782)
+- Improve caching by comparing file hashes as fallback for mtime and size (#3821)
+
+### _Blackd_
+
+- Fix an issue in `blackd` with single character input (#3558)
+
+### Integrations
+
 - Black now has an
   [official pre-commit mirror](https://github.com/psf/black-pre-commit-mirror). Swapping
   `https://github.com/psf/black` to `https://github.com/psf/black-pre-commit-mirror` in
   your `.pre-commit-config.yaml` will make Black about 2x faster (#3828)
 - The `.black.env` folder specified by `ENV_PATH` will now be removed on the completion
-  of the GitHub Action. (#3759)
-
-### Documentation
-
-<!-- Major changes to documentation and policies. Small docs changes
-     don't need a changelog entry. -->
+  of the GitHub Action (#3759)
 
 ## 23.7.0
 
@@ -80,7 +95,6 @@
   (#3740)
 - Fix error in AST validation when _Black_ removes trailing whitespace in a type comment
   (#3773)
-- Fix a bug whereby spaces were removed from walrus operators within subscript (#3823)
 
 ### Preview style
 
@@ -171,8 +185,6 @@ expected to become part of Black's stable style in January 2024.
 - For stubs, enforce one blank line after a nested class with a body other than just
   `...` (#3564)
 - Improve handling of multiline strings by changing line split behavior (#1879)
-- In stub files, add a blank line between a statement with a body (e.g an
-  `if sys.version_info > (3, x):`) and a function definition on the same level. (#3862)
 
 ### Parser
 

docs/contributing/release_process.md

@@ -43,6 +43,8 @@ To cut a release:
    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 <last release> CHANGES.md`)
    1. Add a new empty template for the next release above
       ([template below](#changelog-template))
    1. Update references to the latest version in

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

docs/usage_and_configuration/the_basics.md

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