From ae2c0758c9e61a385df9700dc9c231bf54887041 Mon Sep 17 00:00:00 2001
From: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Date: Mon, 28 Mar 2022 12:08:29 -0700
Subject: [PATCH] Prepare release 22.3.0 (#2968)

---
 CHANGES.md                                  | 57 +++++++++++++--------
 docs/integrations/source_version_control.md |  2 +-
 docs/usage_and_configuration/the_basics.md  |  2 +-
 3 files changed, 39 insertions(+), 22 deletions(-)

diff --git a/CHANGES.md b/CHANGES.md
index 02327fc..f68bc8f 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -14,11 +14,6 @@
 
 <!-- Changes that affect Black's preview style -->
 
-- Code cell separators `#%%` are now standardised to `# %%` (#2919)
-- Remove unnecessary parentheses from `except` statements (#2939)
-- Remove unnecessary parentheses from tuple unpacking in `for` loops (#2945)
-- Avoid magic-trailing-comma in single-element subscripts (#2942)
-
 ### _Blackd_
 
 <!-- Changes to blackd -->
@@ -27,34 +22,62 @@
 
 <!-- Changes to how Black can be configured -->
 
+### Documentation
+
+<!-- Major changes to documentation and policies. Small docs changes
+     don't need a changelog entry. -->
+
+### Integrations
+
+<!-- For example, Docker, GitHub Actions, pre-commit, editors -->
+
+### Output
+
+<!-- Changes to Black's terminal output and error messages -->
+
+### 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. -->
+
+## 22.3.0
+
+### Preview style
+
+- Code cell separators `#%%` are now standardised to `# %%` (#2919)
+- Remove unnecessary parentheses from `except` statements (#2939)
+- Remove unnecessary parentheses from tuple unpacking in `for` loops (#2945)
+- Avoid magic-trailing-comma in single-element subscripts (#2942)
+
+### Configuration
+
 - Do not format `__pypackages__` directories by default (#2836)
 - Add support for specifying stable version with `--required-version` (#2832).
 - Avoid crashing when the user has no homedir (#2814)
 - Avoid crashing when md5 is not available (#2905)
+- Fix handling of directory junctions on Windows (#2904)
 
 ### Documentation
 
-<!-- Major changes to documentation and policies. Small docs changes
-     don't need a changelog entry. -->
-
 - Update pylint config documentation (#2931)
 
 ### Integrations
 
-<!-- For example, Docker, GitHub Actions, pre-commit, editors -->
-
 - Move test to disable plugin in Vim/Neovim, which speeds up loading (#2896)
 
 ### Output
 
-<!-- Changes to Black's terminal output and error messages -->
-
 - In verbose, mode, log when _Black_ is using user-level config (#2861)
 
 ### Packaging
 
-<!-- Changes to how Black is packaged, such as dependency requirements -->
-
 - Fix Black to work with Click 8.1.0 (#2966)
 - On Python 3.11 and newer, use the standard library's `tomllib` instead of `tomli`
   (#2903)
@@ -66,12 +89,6 @@
 - Black can now parse starred expressions in the target of `for` and `async for`
   statements, e.g `for item in *items_1, *items_2: pass` (#2879).
 
-- Fix handling of directory junctions on Windows (#2904)
-
-### Performance
-
-<!-- Changes that improve Black's performance. -->
-
 ## 22.1.0
 
 At long last, _Black_ is no longer a beta product! This is the first non-beta release
diff --git a/docs/integrations/source_version_control.md b/docs/integrations/source_version_control.md
index 7215e11..d7d3da4 100644
--- a/docs/integrations/source_version_control.md
+++ b/docs/integrations/source_version_control.md
@@ -7,7 +7,7 @@ Use [pre-commit](https://pre-commit.com/). Once you
 ```yaml
 repos:
   - repo: https://github.com/psf/black
-    rev: 22.1.0
+    rev: 22.3.0
     hooks:
       - id: black
         # It is recommended to specify the latest version of Python
diff --git a/docs/usage_and_configuration/the_basics.md b/docs/usage_and_configuration/the_basics.md
index 48dda3b..4c793f4 100644
--- a/docs/usage_and_configuration/the_basics.md
+++ b/docs/usage_and_configuration/the_basics.md
@@ -173,7 +173,7 @@ You can check the version of _Black_ you have installed using the `--version` fl
 
 ```console
 $ black --version
-black, version 22.1.0
+black, version 22.3.0
 ```
 
 An option to require a specific version to be running is also provided.
-- 
2.39.5