diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5fd1bfbf7d..67ea0fd736 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,10 @@ This change log adheres to standards from [Keep a CHANGELOG](https://keepachange
### Fixed
* [`display-name`]: fix false positive for HOF returning only nulls ([#3291][] @golopot)
+### Changed
+* [Docs] [`jsx-tag-spacing`]: rename option from [#3264][] ([#3294[] @ljharb)
+
+[#3294]: https://github.com/jsx-eslint/eslint-plugin-react/issues/3294
[#3291]: https://github.com/jsx-eslint/eslint-plugin-react/pull/3291
## [7.30.0] - 2022.05.18
diff --git a/docs/rules/jsx-tag-spacing.md b/docs/rules/jsx-tag-spacing.md
index 9651370a54..9282c5d891 100644
--- a/docs/rules/jsx-tag-spacing.md
+++ b/docs/rules/jsx-tag-spacing.md
@@ -62,7 +62,7 @@ Examples of **correct** code for this rule, when configured with `{ "closingSlas
### `beforeSelfClosing`
-This check can be set to `"always"`, `"never"`, `"multiline-always"`, or `"allow"` (to disable it).
+This check can be set to `"always"`, `"never"`, `"proportional-always"`, or `"allow"` (to disable it).
If it is `"always"`, the check warns whenever a space is missing before the closing bracket. If `"never"` then it warns if a space is present before the closing bracket. The default value of this check is `"always"`.
@@ -102,7 +102,7 @@ Examples of **correct** code for this rule, when configured with `{ "beforeSelfC
/>
```
-Examples of **incorrect** code for this rule, when configured with `{ "beforeSelfClosing": "multiline-always" }`:
+Examples of **incorrect** code for this rule, when configured with `{ "beforeSelfClosing": "proportional-always" }`:
```jsx
```
-Examples of **correct** code for this rule, when configured with `{ "beforeSelfClosing": "multiline-always" }`:
+Examples of **correct** code for this rule, when configured with `{ "beforeSelfClosing": "proportional-always" }`:
```jsx
```
-Examples of **incorrect** code for this rule, when configured with `{ "beforeClosing": "multiline-always" }`:
+Examples of **incorrect** code for this rule, when configured with `{ "beforeClosing": "proportional-always" }`:
```jsx
```
-Examples of **correct** code for this rule, when configured with `{ "beforeClosing": "multiline-always" }`:
+Examples of **correct** code for this rule, when configured with `{ "beforeClosing": "proportional-always" }`:
```jsx