docs(link, tag, taggroup, tooltip): component analysis#5980
Conversation
…tton, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback
…roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group
… roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone.
…ard, swatch + swatchgroup, thumbnail (#5740)
|
📚 Branch Preview Links🔍 First Generation Visual Regression Test ResultsWhen a visual regression test fails (or has previously failed while working on this branch), its results can be found in the following URLs:
Deployed to Azure Blob Storage: If the changes are expected, update the |
|
@aramos-adobe How can i test this? |
|
@Rajdeepc Just added a guide to test the documentation! |
marissahuysentruyt
left a comment
There was a problem hiding this comment.
I noticed was that there were some CSS callouts that were actually from S1, but most things should be for Spectrum 2.
I also had a bunch of questions for you, so I'm happy to pair if you want to talk through anything.
migration-roadmap/link.md
Outdated
| spectrum-Link--quiet (if isQuiet) | ||
| spectrum-Link--[variant] (if variant) | ||
| spectrum-Link--static[StaticColor] (if staticColor) | ||
| is-hover (if isHovered) | ||
| is-active (if isActive) | ||
| is-focus-visible (if isFocused) | ||
| is-visited (if isVisited)" |
There was a problem hiding this comment.
Personally, I don't know that we need all of the parentheses and "(if staticColor)" etc. I'm on the fence about including the is-hover/is-active etc. interaction state class names. Aren't those more Storybook-specific so our controls show the states? I don't know that it hurts to keep them (and this wouldn't be the only component to have them listed here either).
Really, the point of my comment was that we could probably remove all of the if statements in the parentheses! 😆
migration-roadmap/tooltip.md
Outdated
| | `.spectrum-Tooltip--bottom-left` | | Missing from WC | | ||
| | `.spectrum-Tooltip--bottom-right` | | Missing from WC | | ||
| | `.spectrum-Tooltip--top-left` | | Missing from WC | | ||
| | `.spectrum-Tooltip--top-right` | | Missing from WC | | ||
| | `.spectrum-Tooltip--left-bottom` | | Missing from WC | | ||
| | `.spectrum-Tooltip--left-top` | | Missing from WC | | ||
| | `.spectrum-Tooltip--right-bottom` | | Missing from WC | | ||
| | `.spectrum-Tooltip--right-top` | | Missing from WC | | ||
| | `.spectrum-Tooltip--start` | | Missing from WC | | ||
| | `.spectrum-Tooltip--start-top` | | Missing from WC | | ||
| | `.spectrum-Tooltip--start-bottom` | | Missing from WC | | ||
| | `.spectrum-Tooltip--end` | | Missing from WC | | ||
| | `.spectrum-Tooltip--end-top` | | Missing from WC | | ||
| | `.spectrum-Tooltip--end-bottom` | | Missing from WC | |
There was a problem hiding this comment.
These all sound like "non-logical" properties instead. I wonder if you could figure out each one of these and map it back to the logical property version instead. For instance, bottom-left sounds like maybe it could be the same positioning as left-end? Does that make sense?
rise-erpelding
left a comment
There was a problem hiding this comment.
This is shaping up nicely, I read through Tag & Tag Group and am leaving comments for those, I'll come back for Link and Tooltip later!
migration-roadmap/taggroup.md
Outdated
| - `.spectrum-TagGroup-actionButton` | ||
| - `.spectrum-TagGroup-helpText` | ||
| - `.spectrum-TagGroup-label` | ||
| - `.spectrum-TagGroup-tag` |
There was a problem hiding this comment.
The template adds this .spectrum-TagGroup-tag class but we never use it in the CSS. (Therefore when you compare with the metadata.json it's not there.)
No action needed here, just wanted to point it out in case anyone is questioning why it's here.
There was a problem hiding this comment.
@rise-erpelding, it could be a selector possibly used in the future?
There was a problem hiding this comment.
Totally! I think that must have been the line of thinking in adding it in the template even though it was never used, and keeping a similar selector in 2nd-gen seems logical to me.
Again, nothing about this needs to be changed! I just wanted to point it out in case anyone else is wondering where it came from.
migration-roadmap/taggroup.md
Outdated
|
|
||
| ### SWC | ||
|
|
||
| **Note**: In Spectrum Web Components, this component is named `<sp-tags>` (not `<sp-taggroup>`). |
migration-roadmap/taggroup.md
Outdated
| **Component structure:** | ||
|
|
||
| - Wrapper element with `spectrum-TagGroup` class and size modifiers (`--sizeS`, `--sizeM`, `--sizeL`) | ||
| - Optional `spectrum-TagGroup-label` for field labels (top or side positioning via `--sideLabel` modifier) | ||
| - `spectrum-TagGroup-tags` container with `role="list"` and `aria-label` for semantic grouping | ||
| - Individual tags receive `spectrum-TagGroup-tag` class for consistent styling | ||
| - Optional `spectrum-TagGroup-actionButton` for actions related to the tag group | ||
| - Optional `spectrum-TagGroup-helpText` for additional context or validation messages | ||
|
|
||
| **Key features:** | ||
|
|
||
| - Flexible layout supporting both top and side label positioning | ||
| - Semantic HTML structure with proper ARIA roles for accessibility | ||
| - Support for custom styles and modifiers for spacing | ||
| - Integration with FieldLabel, ActionButton, and HelpText components | ||
| - Tag wrapping behavior when horizontal space is limited |
There was a problem hiding this comment.
While this isn't hurting anything, comparing to other components we've done usually this ### CSS Spectrum 2 changes is pretty short and sweet, either "no structural changes" or a short list of things that are different.
...BUTOR-DOCS/03_project-planning/03_components/tag/rendering-and-styling-migration-analysis.md
Show resolved
Hide resolved
rise-erpelding
left a comment
There was a problem hiding this comment.
A few comments for Tooltip and Link!
...R-DOCS/03_project-planning/03_components/tooltip/rendering-and-styling-migration-analysis.md
Show resolved
Hide resolved
…tton, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback
…roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group
… roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone.
…ard, swatch + swatchgroup, thumbnail (#5740)
When changing doc structure or headings, point readers to Authoring contributor docs for running the nav script and link verification. (Cursor said it would do a better job if I added this to the documentation.)
- 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"
48fb02e to
dfad5ac
Compare
…m-web-components into 2nd-gen-component-analysis
…ink-tag-group-migration-docs
5dece21 to
3a90238
Compare
…ink-tag-group-migration-docs
rise-erpelding
left a comment
There was a problem hiding this comment.
This one's really close for me! Just noting a few things that I think need changing, plus a couple of nits.
...BUTOR-DOCS/03_project-planning/03_components/tag/rendering-and-styling-migration-analysis.md
Outdated
Show resolved
Hide resolved
...BUTOR-DOCS/03_project-planning/03_components/tag/rendering-and-styling-migration-analysis.md
Show resolved
Hide resolved
...UTOR-DOCS/03_project-planning/03_components/tags/rendering-and-styling-migration-analysis.md
Outdated
Show resolved
Hide resolved
...R-DOCS/03_project-planning/03_components/tooltip/rendering-and-styling-migration-analysis.md
Outdated
Show resolved
Hide resolved
…github.com:adobe/spectrum-web-components into aramos-adobe/swc1222-link-tag-group-migration-docs
rise-erpelding
left a comment
There was a problem hiding this comment.
All of my previous comments have been addressed, this looks fantastic! I made one very small suggestion about tooltip, but these are great component analyses!
...R-DOCS/03_project-planning/03_components/tooltip/rendering-and-styling-migration-analysis.md
Outdated
Show resolved
Hide resolved
marissahuysentruyt
left a comment
There was a problem hiding this comment.
I'm going to approve! Thank you for sticking with this one!
I left one comment that isn't really blocking- just an enhancement to make the "no tip" thing for the S2 tooltip clearer. 👍
...R-DOCS/03_project-planning/03_components/tooltip/rendering-and-styling-migration-analysis.md
Show resolved
Hide resolved
* chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * first docs feedback * docs(link): WIP * docs(s2): addressing feedback in link, tag, tooltip * docs(swc): review feedback pt 3 * chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * docs(s2): migrating new comments * docs(s2): addressing more feedback * docs(s2): addressing tooltip feedback * docs(s2): update link, tag, group and tt * docs(s2): updating feedback from marissa * chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * chore: add cursor rule for CONTRIBUTOR-DOCS * docs: add CONTRIBUTOR-DOCSreminder to regenerate nav and verify links When changing doc structure or headings, point readers to Authoring contributor docs for running the nav script and link verification. (Cursor said it would do a better job if I added this to the documentation.) * docs: move component analysis docs into CONTRIBUTOR-DOCS * chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * chore: add cursor rule for CONTRIBUTOR-DOCS * docs(s2): re-review docs * docs: add CONTRIBUTOR-DOCS reminder to regenerate nav and verify links When changing doc structure or headings, point readers to Authoring contributor docs for running the nav script and link verification. (Cursor said it would do a better job if I added this to the documentation.) * docs: move component analysis docs into CONTRIBUTOR-DOCS * 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 * first docs feedback * docs(link): WIP * docs(s2): addressing feedback in link, tag, tooltip * docs(swc): review feedback pt 3 * docs(s2): migrating new comments * docs(s2): addressing more feedback * docs(s2): addressing tooltip feedback * docs(s2): update link, tag, group and tt * docs(s2): updating feedback from marissa * docs(s2): re-review docs * chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * chore: update cursor rule for CONTRIBUTOR-DOCS * docs: add CONTRIBUTOR-DOCS reminder to regenerate nav and verify links When changing doc structure or headings, point readers to Authoring contributor docs for running the nav script and link verification. (Cursor said it would do a better job if I added this to the documentation.) * docs: move component analysis docs into CONTRIBUTOR-DOCS * 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" * docs(s2): updating file structure * docs(s2): addressing rise feedback * docs(s2): updating tooltip docs --------- Co-authored-by: Marissa Huysentruyt <marissa.huysentruyt@heysparkbox.com> Co-authored-by: rise-erpelding <54716846+rise-erpelding@users.noreply.github.com> Co-authored-by: Cory Dransfeldt <hi@coryd.dev> Co-authored-by: Marissa Huysentruyt <69602589+marissahuysentruyt@users.noreply.github.com> Co-authored-by: Rise Erpelding <rise@heysparkbox.com>
* chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * first docs feedback * docs(link): WIP * docs(s2): addressing feedback in link, tag, tooltip * docs(swc): review feedback pt 3 * chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * docs(s2): migrating new comments * docs(s2): addressing more feedback * docs(s2): addressing tooltip feedback * docs(s2): update link, tag, group and tt * docs(s2): updating feedback from marissa * chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * chore: add cursor rule for CONTRIBUTOR-DOCS * docs: add CONTRIBUTOR-DOCSreminder to regenerate nav and verify links When changing doc structure or headings, point readers to Authoring contributor docs for running the nav script and link verification. (Cursor said it would do a better job if I added this to the documentation.) * docs: move component analysis docs into CONTRIBUTOR-DOCS * chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * chore: add cursor rule for CONTRIBUTOR-DOCS * docs(s2): re-review docs * docs: add CONTRIBUTOR-DOCS reminder to regenerate nav and verify links When changing doc structure or headings, point readers to Authoring contributor docs for running the nav script and link verification. (Cursor said it would do a better job if I added this to the documentation.) * docs: move component analysis docs into CONTRIBUTOR-DOCS * 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 * first docs feedback * docs(link): WIP * docs(s2): addressing feedback in link, tag, tooltip * docs(swc): review feedback pt 3 * docs(s2): migrating new comments * docs(s2): addressing more feedback * docs(s2): addressing tooltip feedback * docs(s2): update link, tag, group and tt * docs(s2): updating feedback from marissa * docs(s2): re-review docs * chore: add cursor prompt * docs: add prompt output files for subset of components * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * chore(docs): address feedback * chore(docs): address feedback * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs(checkbox): migration roadmap * docs(fieldgroup): migration roadmap * docs(radio): migration roadmap * docs(switch): migration roadmap * docs(checkbox, field-group): update migration roadmap - gives clarification on invalid checkbox consideration - clarifies some of the implementation gaps for field group * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * docs: add component analysis docs adds migration roadmap and component analysis docs for meter, progress bar, slider, illustrated message and drop zone. * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * chore: update cursor rule for CONTRIBUTOR-DOCS * docs: add CONTRIBUTOR-DOCS reminder to regenerate nav and verify links When changing doc structure or headings, point readers to Authoring contributor docs for running the nav script and link verification. (Cursor said it would do a better job if I added this to the documentation.) * docs: move component analysis docs into CONTRIBUTOR-DOCS * 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" * docs(s2): updating file structure * docs(s2): addressing rise feedback * docs(s2): updating tooltip docs --------- Co-authored-by: Marissa Huysentruyt <marissa.huysentruyt@heysparkbox.com> Co-authored-by: rise-erpelding <54716846+rise-erpelding@users.noreply.github.com> Co-authored-by: Cory Dransfeldt <hi@coryd.dev> Co-authored-by: Marissa Huysentruyt <69602589+marissahuysentruyt@users.noreply.github.com> Co-authored-by: Rise Erpelding <rise@heysparkbox.com>
* chore: add cursor prompt * docs: barebones component analysis docs, prompt updates (#5720) * chore(docs): barebones analysis for Field label, Help text, Picker button, In-field button and In-field progress circle (#5738) * chore(docs): barebones analysis for SWC-1218 * docs(switch,radio,checkbox,fieldgroup): component analysis migration roadmap (#5729) * docs: textfield-based component analysis docs (#5741) * docs(slider,meter,progressbar,dropzone,illustratedmessage): migration roadmap (#5775) * chore(docs): 2nd gen component analysis for avatar, opacity checkerboard, swatch + swatchgroup, thumbnail (#5740) * docs(button, buttongroup, actionbutton, actiongroup): component analysis (#5788) * chore: update cursor rule for CONTRIBUTOR-DOCS * docs: move component analysis docs into CONTRIBUTOR-DOCS * docs(link, tag, taggroup, tooltip): component analysis (#5980) --------- Co-authored-by: Marissa Huysentruyt <marissa.huysentruyt@heysparkbox.com> Co-authored-by: Cory Dransfeldt <hi@coryd.dev> Co-authored-by: Marissa Huysentruyt <69602589+marissahuysentruyt@users.noreply.github.com> Co-authored-by: aramos-adobe <abdulr@adobe.com>
Description
Creates AI-generated migration documentation to analyze component differences to guide SWC migration to S2, with human vetting. The documentation serves as a bridge between the migrated Spectrum 2 CSS work and the corresponding web components, in order to help engineers understand what needs to be implemented, updated, or aligned between the two systems to guide the development of 2nd generation web components.
This batch is for the components: Link, Tag, Tag group, Tooltip.
Motivation and context
Related issue(s)
SWC-1222
Screenshots (if appropriate)
N/A - Documentation only
Author's checklist
Manual review test cases
Documentation Quality
Cross-Reference Accuracy
metadata.jsonfilesDevice review