Add breaking change doc for isFocusable

src/content/release/breaking-changes/deprecate-focusable.md

@@ -0,0 +1,98 @@
+---
+title: Deprecate `SemanticsProperties.focusable` and `SemanticsConfiguration.isFocusable`
+description: >
+  The `focusable` parameter has been replaced by `isFocused`.
+---
+
+## Summary
+
+The `SemanticsProperties.focusable` and `SemanticsConfiguration.isFocusable`
+parameters were deprecated in favor of the `SemanticsProperties.focused` and
+`SemanticsConfiguration.isFocused` parameters.
+
+## Context
+
+The `SemanticsConfiguration.isFocusable` is a boolean to describe
+whether the semantics node can have input focus, and
+`SemanticsConfiguration.isFocused` is a boolean to describe if the
+semantics node has input focus.
+
+The fix is the same with `SemanticsProperties.focusable` and `SemanticsProperties.focused`.
+
+## Description of change
+
+The `SemanticsConfiguration.isFocusable` is deprecated in
+favor of `SemanticsConfiguration.isFocused`, which is a nullable boolean;
+setting it to true/false automatically sets `isFocusable` to `true`,
+and setting it to null sets `isFocusable` to `false`.
+
+## Migration guide
+
+Replace `SemanticsConfiguration.isFocusable` with `SemanticsConfiguration.isFocused`.
+
+### Example 1: setting `isFocused` to `true` automatically sets `isFocusable` to `true`.
+
+Code before migration:
+
+```dart
+void describeSemanticsConfiguration(SemanticsConfiguration config) {
+  config.isFocusable = true;
+  config.isFocused = true;
+}
+```
+
+Code after migration:
+
+```dart
+void describeSemanticsConfiguration(SemanticsConfiguration config) {
+  config.isFocused = true;
+}
+```
+
+### Example 2: setting `isFocused` to null automatically sets `isFocusable` to `false`.
+
+Code before migration:
+
+```dart
+void describeSemanticsConfiguration(SemanticsConfiguration config) {
+  config.isFocusable = false;
+  config.isFocused = false;
+}
+```
+
+Code after migration:
+
+```dart
+void describeSemanticsConfiguration(SemanticsConfiguration config) {
+  config.isFocused = null;
+}
+```
+
+
+## Timeline
+
+Landed in version: Not yet<br>
+In stable release: Not yet
+
+
+## References
+
+API documentation:
+
+* [`SemanticsConfiguration`][]
+* [`SemanticsProperties`][]
+* [`SemanticsNode`][]
+
+Relevant issue:
+
+* [Issue 166092][]
+
+Relevant PR:
+
+* [PR 170935][]
+
+[`SemanticsConfiguration`]: {{site.api}}/flutter/semantics/SemanticsConfiguration-class.html
+[`SemanticsProperties`]: {{site.api}}/flutter/semantics/SemanticsProperties-class.html
+[`SemanticsNode`]: {{site.api}}/flutter/semantics/SemanticsNode-class.html
+[Issue 166101]: {{site.repo.flutter}}/issues/166101
+[PR 168703]: {{site.repo.flutter}}/pull/170935

src/content/release/breaking-changes/index.md

@@ -48,13 +48,15 @@ They're sorted by release and listed in alphabetical order:
 * [Stop generating `AssetManifest.json`][]
 * [UISceneDelegate adoption][]
 * [Component theme normalization updates][]
+* [Deprecate `SemanticsProperties.focusable` and `SemanticsConfiguration.isFocusable`][]
 
 [Redesigned the Radio Widget]: /release/breaking-changes/radio-api-redesign
 [Removed semantics elevation and thickness]: /release/breaking-changes/remove-semantics-elevation-and-thickness
 [Deprecate `TextField.canRequestFocus`]: /release/breaking-changes/can-request-focus
 [Stop generating `AssetManifest.json`]: /release/breaking-changes/asset-manifest-dot-json
 [UISceneDelegate adoption]: /release/breaking-changes/uiscenedelegate
 [Component theme normalization updates]: /release/breaking-changes/component-theme-normalization-updates
+[Deprecate `SemanticsProperties.focusable` and `SemanticsConfiguration.isFocusable`]: /release/breaking-changes/deprecate-focusable
 
 <a id="released-in-flutter-332" aria-hidden="true"></a>
 ### Released in Flutter 3.32