docs: migration guides for Button t-shirt sizing

components/actionbutton/metadata/actionbutton.yml

@@ -8,6 +8,9 @@ description: |
 sections:
   - name: Migration Guide
     description: |
+      ### T-shirt sizing
+      Action Button now supports t-shirt sizing and requires that you specify the size of button by adding a `.spectrum-ActionButton--size*` class.
+
       ### Action Button is now a separate component
       Action Button has been moved to the [Action Button](actionbutton.html) component.
 

components/button/metadata/button-cta.yml

@@ -2,6 +2,11 @@ name: Button - CTA
 status: Verified
 description: The call to action button communicates strong emphasis and is reserved for encouraging critical actions.
 SpectrumSiteSlug: https://spectrum.adobe.com/page/button/
+sections:
+  - name: Migration Guide
+    description: |
+      ### T-shirt sizing
+      Button now supports t-shirt sizing and requires that you specify the size of button by adding a `.spectrum-Button--size*` class.
 examples:
   - id: button-cta
     name: Sizing

components/button/metadata/button-over-background.yml

@@ -2,6 +2,22 @@ name: Button - Over Background
 status: Verified
 description: 'When a button needs to be placed on top of a colored background or a visual, use the over background button. In order to implement this button, you must set the CSS color property of a parent element to the same value as the background the button is placed against.'
 SpectrumSiteSlug: https://spectrum.adobe.com/page/button/#Over-background
+sections:
+  - name: Migration Guide
+    description: |
+      ### T-shirt sizing
+      Button now supports t-shirt sizing and requires that you specify the size of button by adding a `.spectrum-Button--size*` class.
+
+      ### Change workflow icon size
+
+      Previously, all Buttons used `.spectrum-Icon--sizeS`. This has changed:
+
+      | Action Button Class        | Workflow Icon Class               |
+      | -------------------------- | --------------------------------- |
+      | `.spectrum-Button--sizeS`  | `.spectrum-Icon--sizeS`           |
+      | `.spectrum-Button--sizeM`  | `.spectrum-Icon--sizeM`           |
+      | `.spectrum-Button--sizeL`  | `.spectrum-Icon--sizeL`           |
+      | `.spectrum-Button--sizeXL` | `.spectrum-Icon--sizeXL`          |
 examples:
   - id: button-over-background
     name: Over background

components/button/metadata/button-primary.yml

@@ -3,10 +3,21 @@ status: Verified
 description: The primary button is used for medium emphasis.
 SpectrumSiteSlug: https://spectrum.adobe.com/page/button/#Primary
 sections:
-- name: Migration Guide
-  description: |
-    ### Change workflow icon size to medium
-    Replace `.spectrum-Icon--sizeS` with `.spectrum-Icon--sizeM`.
+  - name: Migration Guide
+    description: |
+      ### T-shirt sizing
+      Button now supports t-shirt sizing and requires that you specify the size of button by adding a `.spectrum-Button--size*` class.
+
+      ### Change workflow icon size
+
+      Previously, all Buttons used `.spectrum-Icon--sizeS`. This has changed:
+
+      | Action Button Class        | Workflow Icon Class               |
+      | -------------------------- | --------------------------------- |
+      | `.spectrum-Button--sizeS`  | `.spectrum-Icon--sizeS`           |
+      | `.spectrum-Button--sizeM`  | `.spectrum-Icon--sizeM`           |
+      | `.spectrum-Button--sizeL`  | `.spectrum-Icon--sizeL`           |
+      | `.spectrum-Button--sizeXL` | `.spectrum-Icon--sizeXL`          |
 examples:
   - id: button-primary
     name: Sizing

components/button/metadata/button-secondary.yml

@@ -3,10 +3,21 @@ status: Verified
 description: The secondary button is for low emphasis.
 SpectrumSiteSlug: https://spectrum.adobe.com/page/button/#Secondary
 sections:
-- name: Migration Guide
-  description: |
-    ### Change workflow icon size to medium
-    Replace `.spectrum-Icon--sizeS` with `.spectrum-Icon--sizeM`.
+  - name: Migration Guide
+    description: |
+      ### T-shirt sizing
+      Button now supports t-shirt sizing and requires that you specify the size of button by adding a `.spectrum-Button--size*` class.
+
+      ### Change workflow icon size
+
+      Previously, all Buttons used `.spectrum-Icon--sizeS`. This has changed:
+
+      | Action Button Class        | Workflow Icon Class               |
+      | -------------------------- | --------------------------------- |
+      | `.spectrum-Button--sizeS`  | `.spectrum-Icon--sizeS`           |
+      | `.spectrum-Button--sizeM`  | `.spectrum-Icon--sizeM`           |
+      | `.spectrum-Button--sizeL`  | `.spectrum-Icon--sizeL`           |
+      | `.spectrum-Button--sizeXL` | `.spectrum-Icon--sizeXL`          |
 examples:
   - id: button-secondary
     name: Sizing

components/button/metadata/button-warning.yml

@@ -3,10 +3,21 @@ status: Verified
 description: The negative button is for high emphasis of negative or destructive actions.
 SpectrumSiteSlug: https://spectrum.adobe.com/page/button/#Negative
 sections:
-- name: Migration Guide
-  description: |
-    ### Change workflow icon size to medium
-    Replace `.spectrum-Icon--sizeS` with `.spectrum-Icon--sizeM`.
+  - name: Migration Guide
+    description: |
+      ### T-shirt sizing
+      Button now supports t-shirt sizing and requires that you specify the size of button by adding a `.spectrum-Button--size*` class.
+
+      ### Change workflow icon size
+
+      Previously, all Buttons used `.spectrum-Icon--sizeS`. This has changed:
+
+      | Action Button Class        | Workflow Icon Class               |
+      | -------------------------- | --------------------------------- |
+      | `.spectrum-Button--sizeS`  | `.spectrum-Icon--sizeS`           |
+      | `.spectrum-Button--sizeM`  | `.spectrum-Icon--sizeM`           |
+      | `.spectrum-Button--sizeL`  | `.spectrum-Icon--sizeL`           |
+      | `.spectrum-Button--sizeXL` | `.spectrum-Icon--sizeXL`          |
 examples:
   - id: button-warning
     name: Sizing