Docs: DOC-3526 - Document tinymceai_reviews_change_tone_menu option (TINY-14274)

Add the tinymceai_reviews_change_tone_menu configuration option to the
TinyMCE AI options reference and link to it from the 8.7.0 release note.
Correct the release note: an empty array is accepted with a warning and
does not hide the Change Tone review.

Author: kemister85

modules/ROOT/pages/8.7.0-release-notes.adoc

@@ -37,7 +37,7 @@ The {productname} {release-version} release includes an accompanying release of
 ==== New `tinymceai_reviews_change_tone_menu` option to control the Change Tone review menu
 // #TINY-14274
 
-{productname} {release-version} adds the `+tinymceai_reviews_change_tone_menu+` option for **TinyMCE AI**, which controls the tone options shown in the Change Tone review menu. Only preset tone IDs are supported, the configured order is reflected in the menu, and duplicate values are removed. An invalid configuration falls back to the default tones, and an empty array (`+[]+`) hides the Change Tone review.
+{productname} {release-version} adds the `+tinymceai_reviews_change_tone_menu+` option for **TinyMCE AI**, which controls the tone options shown in the Change Tone review and their order. Only preset tone IDs are supported, the configured order is reflected in the menu, and duplicate values are removed. An invalid configuration falls back to the default tones. For the full list of tone IDs and behavior, see the xref:tinymceai.adoc#tinymceai_reviews_change_tone_menu[`+tinymceai_reviews_change_tone_menu+`] option.
 
 For information on the **TinyMCE AI** plugin, see: xref:tinymceai.adoc[TinyMCE AI].
 

modules/ROOT/partials/configuration/tinymceai_options.adoc

@@ -563,3 +563,52 @@ tinymce.init({
 });
 ----
 
+[[tinymceai_reviews_change_tone_menu]]
+=== `+tinymceai_reviews_change_tone_menu+`
+
+Array of tone control IDs that define which tone options appear in the Change Tone review, and their order. Only the listed tones are available to users.
+
+This option applies only when `+'ai-reviews-change-tone'+` is included in the xref:tinymceai.adoc#tinymceai_reviews[`+tinymceai_reviews+`] option.
+
+*Type:* `+Array+` of `+String+`
+
+*Valid values:*
+
+* `+'ai-reviews-tone-casual'+`: Casual tone
+* `+'ai-reviews-tone-direct'+`: Direct tone
+* `+'ai-reviews-tone-friendly'+`: Friendly tone
+* `+'ai-reviews-tone-confident'+`: Confident tone
+* `+'ai-reviews-tone-professional'+`: Professional tone
+
+Duplicate IDs are removed, and the configured order is reflected in the menu. If the option contains any value that is not a valid tone ID, the configuration is rejected and the default tones are used. An empty array (`+[]+`) is accepted but logs a console warning. To remove the Change Tone review entirely, omit `+'ai-reviews-change-tone'+` from the xref:tinymceai.adoc#tinymceai_reviews[`+tinymceai_reviews+`] option.
+
+*Default value:*
+[source,js]
+----
+[
+  'ai-reviews-tone-casual',
+  'ai-reviews-tone-direct',
+  'ai-reviews-tone-friendly',
+  'ai-reviews-tone-confident',
+  'ai-reviews-tone-professional'
+]
+----
+
+.Example
+[source,js]
+----
+tinymce.init({
+  selector: 'textarea',
+  plugins: 'tinymceai',
+  toolbar: 'tinymceai-chat tinymceai-quickactions tinymceai-review',
+  tinymceai_reviews_change_tone_menu: [
+    'ai-reviews-tone-professional',
+    'ai-reviews-tone-friendly'
+  ],
+  // Required for authentication
+  tinymceai_token_provider: () => {
+    return fetch('/api/token').then(r => r.json());
+  }
+});
+----
+