chore: clean up component analysis docs

- Add content to the components README
- Update broken React links
- Add status note for POC components in migration analysis docs
- Update component status table
- name change "Spectrum 2 migration roadmap" to "Analyze rendering and
styling"

Author: rise-erpelding

CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/01_status.md

@@ -1,10 +1,10 @@
 <!-- Generated breadcrumbs - DO NOT EDIT -->
 
-[CONTRIBUTOR-DOCS](../../../../../README.md) / [Project planning](../../../../README.md) / [Workstreams](../../../README.md) / [2nd-gen Component Migration](../../README.md) / Step By Step / Spectrum 2 migration roadmap
+[CONTRIBUTOR-DOCS](../../../../../README.md) / [Project planning](../../../../README.md) / [Workstreams](../../../README.md) / [2nd-gen Component Migration](../../README.md) / Step By Step / Analyze rendering and styling
 
 <!-- Document title (editable) -->
 
-# Spectrum 2 migration roadmap
+# Analyze rendering and styling
 
 <!-- Generated TOC - DO NOT EDIT -->
 

CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/02_step-by-step/01_analyze-rendering-and-styling/README.md

@@ -1,6 +1,6 @@
 <!-- Generated breadcrumbs - DO NOT EDIT -->
 
-[CONTRIBUTOR-DOCS](../../../../../README.md) / [Project planning](../../../../README.md) / [Workstreams](../../../README.md) / [2nd-gen Component Migration](../../README.md) / Step By Step / [Spectrum 2 migration roadmap](README.md) / Spectrum Migration Documentation Prompt
+[CONTRIBUTOR-DOCS](../../../../../README.md) / [Project planning](../../../../README.md) / [Workstreams](../../../README.md) / [2nd-gen Component Migration](../../README.md) / Step By Step / [Analyze rendering and styling](README.md) / Spectrum Migration Documentation Prompt
 
 <!-- Document title (editable) -->
 
@@ -23,7 +23,7 @@
 
 <!-- Document content (editable) -->
 
-For the **[COMPONENT_NAME]** component(s), create comprehensive migration documentation in individual markdown files within the `migration-roadmap/` directory of the spectrum-web-components repository, following this exact structure:
+For the **[COMPONENT_NAME]** component(s), create comprehensive migration documentation in individual markdown files under CONTRIBUTOR-DOCS: one file per component in `CONTRIBUTOR-DOCS/03_project-planning/03_components/[component-name]/rendering-and-styling-migration-analysis.md`, following this exact structure:
 
 **IMPORTANT**: All files must be created on the original spectrum-web-components branch where the session started.
 
@@ -253,8 +253,8 @@ Under this heading, add a placeholder section for resources with a bulleted list
 
 ## Output format notes
 
-- Create individual markdown files in the migration-roadmap/ directory
-- Use component names from spectrum-web-components repository for filenames
+- Create one markdown file per component at `CONTRIBUTOR-DOCS/03_project-planning/03_components/[component-name]/rendering-and-styling-migration-analysis.md` (use the component's kebab-case folder name from spectrum-web-components)
+- The filename is always `rendering-and-styling-migration-analysis.md`; the folder name is the component name
 - Use proper markdown formatting with Level 1 heading for component name
 - Ensure all <details> elements are properly closed
 - Use consistent table formatting

CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/02_step-by-step/01_analyze-rendering-and-styling/cursor_prompt.md

@@ -13,7 +13,7 @@
 
 - [Status](01_status.md)
 - Step By Step
-    - [Spectrum 2 migration roadmap](02_step-by-step/01_analyze-rendering-and-styling/README.md)
+    - [Analyze rendering and styling](02_step-by-step/01_analyze-rendering-and-styling/README.md)
     - [Factor rendering out of 1st-gen component](02_step-by-step/02_factor-rendering-out-of-1st-gen-component.md)
     - [Move base class to 2nd-gen core](02_step-by-step/03_move-base-class-to-2nd-gen-core.md)
     - [Formalize Spectrum data model](02_step-by-step/04_formalize-spectrum-data-model.md)

CONTRIBUTOR-DOCS/03_project-planning/02_workstreams/02_2nd-gen-component-migration/README.md

@@ -8,6 +8,13 @@
 
 <!-- Generated TOC - DO NOT EDIT -->
 
+<details open>
+<summary><strong>In this doc</strong></summary>
+
+- [About this section](#about-this-section)
+
+</details>
+
 <details open>
 <summary><strong>Beneath this doc</strong></summary>
 
@@ -86,4 +93,10 @@
 
 <!-- Document content (editable) -->
 
-(Content to be added)
+## About this section
+
+This section provides a **component-centric view** of individual components and how they are affected by multiple workstreams. Use it to understand each component's roadmap and status.
+
+Each component has its own folder (kebab-case). Inside you'll find analysis and planning docs for that component—for example, **rendering-and-styling-migration-analysis.md** for Spectrum 2 CSS-to-SWC migration. The same structure is intended for future peer docs (e.g. a11y analysis, comparative API analysis).
+
+For a workstream-centric view of the same work, see [Workstreams](../02_workstreams/README.md). For how the two views fit together, see the [Project planning overview](../README.md).

CONTRIBUTOR-DOCS/03_project-planning/03_components/README.md

@@ -417,4 +417,4 @@ The Action Button template is functionally identical between the main branch (le
 
 - [CSS migration](https://github.com/adobe/spectrum-css/pull/2669)
 - [Spectrum 2 preview](https://spectrumcss.z13.web.core.windows.net/pr-2352/index.html?path=/docs/components-action-button--docs)
-- [React](https://react-spectrum.adobe.com/s2/index.html?path=/docs/actionbutton--docs)
+- [React](https://react-spectrum.adobe.com/ActionButton)

CONTRIBUTOR-DOCS/03_project-planning/03_components/action-button/rendering-and-styling-migration-analysis.md

@@ -317,4 +317,4 @@ All spacing, border radius, and layout changes are handled through CSS custom pr
 
 - [CSS migration](https://github.com/adobe/spectrum-css/pull/2453)
 - [Spectrum 2 preview](https://spectrumcss.z13.web.core.windows.net/pr-2352/index.html?path=/docs/components-action-group--docs)
-- [React](https://react-spectrum.adobe.com/s2/index.html?path=/docs/actionbuttongroup--docs)
+- [React](https://react-spectrum.adobe.com/ActionButtonGroup)

CONTRIBUTOR-DOCS/03_project-planning/03_components/action-group/rendering-and-styling-migration-analysis.md

@@ -22,6 +22,8 @@
 
 <!-- Document content (editable) -->
 
+> **Status:** This analysis is a POC and not final. Full migration analysis for this component is tracked in SWC-1228.
+
 <details>
 <summary>CSS selectors</summary>
 

CONTRIBUTOR-DOCS/03_project-planning/03_components/alert-dialog/rendering-and-styling-migration-analysis.md

@@ -240,4 +240,4 @@ No significant structural changes between CSS main and spectrum-two branches. Th
 
 - [CSS migration](https://github.com/adobe/spectrum-css/pull/3355)
 - [Spectrum 2 preview](https://spectrumcss.z13.web.core.windows.net/pr-2352/index.html?path=/docs/components-avatar--docs)
-- [React](https://react-spectrum.adobe.com/s2/index.html?path=/docs/avatar--docs)
+- [React](https://react-spectrum.adobe.com/Avatar)

CONTRIBUTOR-DOCS/03_project-planning/03_components/avatar/rendering-and-styling-migration-analysis.md

@@ -351,4 +351,4 @@ No significant structural changes.
 
 - [CSS migration](https://github.com/adobe/spectrum-css/pull/3740)
 - [Spectrum 2 preview](https://spectrumcss.z13.web.core.windows.net/pr-2352/index.html?path=/docs/components-badge--docs)
-- [React](https://react-spectrum.adobe.com/s2/index.html?path=/docs/badge--docs)
+- [React](https://react-spectrum.adobe.com/Badge)