From fa44eff36f551df642af26579c003fdebeffdf17 Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Tue, 23 Sep 2025 22:15:11 -0700
Subject: [PATCH] More migration docs

---
 site/src/content/docs/forms/form-control.mdx |  2 +-
 site/src/content/docs/migration.mdx          | 17 ++++++++++++++++-
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/site/src/content/docs/forms/form-control.mdx b/site/src/content/docs/forms/form-control.mdx
index df3f1d3e6e..11ff8fab27 100644
--- a/site/src/content/docs/forms/form-control.mdx
+++ b/site/src/content/docs/forms/form-control.mdx
@@ -1,6 +1,6 @@
 ---
 title: Form controls
-description: Give textual `<input>`s, `<textarea>`s, and `<select>`s an upgrade with custom styles, sizing, focus states, and more.
+description: Give textual `<input>`, `<textarea>`, and `<select>` elements an upgrade with custom styles, sizing, focus states, and more.
 toc: true
 ---
 
diff --git a/site/src/content/docs/migration.mdx b/site/src/content/docs/migration.mdx
index 9e80d14520..b7f9729ca2 100644
--- a/site/src/content/docs/migration.mdx
+++ b/site/src/content/docs/migration.mdx
@@ -5,7 +5,7 @@ aliases: "/migration/"
 toc: true
 ---
 
-## v6.0.0
+## v6.0.0 Changelog
 
 ### CSS
 
@@ -44,6 +44,21 @@ toc: true
 
 - Relocated heading classes (like `.h1`) and some type classes (`.mark` and `.small`) to Reboot from `_type.scss`. This avoids a dependency in Sass modules and we like to avoid extending selectors in general.
 
+### Forms
+
+- **Refactor checks, radios, and switches.**
+  - Split apart `_form-check.scss` into separate stylesheets: `_checkbox.scss`, `_radio.scss`, and `_switch.scss`.
+  - Also split apart the documentation pages for checks, radios, and switches.
+  - Added new CSS variables on each of these components. _Side note: we could've shared variables here, but chose not to for simplicity's sake._
+  - Removed several now unused Sass variables.
+  - Checkboxes now have a wrapping element and an SVG in the DOM for checked and indeterminate states. Radios and switches do not.
+  - Revamped layout for checks, radios, and switches with labels (and descriptions). We now have custom elements for layout that include basic flexbox styling.
+  - @mdo-do: Decide on fate of `.form-check-reverse`.
+- **Consolidate `.form-select` into `.form-control`.**
+  - Removed `.form-select`—use `.form-control` on `<select>` elements now. Too much abstraction and duplication at the same time.
+  - Adds new CSS variables on `.form-control` for easier customization without Sass compilation.
+  - `.form-control` now has a `min-height` at all times as opposed to just on `<textarea>` elements. This reduces some CSS for us.
+
 ### Helpers
 
 - Ratio helpers have been moved to utilities.
-- 
2.47.3