Skip to content

[Components]: Description improvements for version 2026-01#3820

Open
mcvinci wants to merge 1 commit into2026-01from
admin-ui-component-descriptions-2026-01
Open

[Components]: Description improvements for version 2026-01#3820
mcvinci wants to merge 1 commit into2026-01from
admin-ui-component-descriptions-2026-01

Conversation

@mcvinci
Copy link
Contributor

@mcvinci mcvinci commented Feb 5, 2026

You can preview individual component pages on staging 8:

Reviewers

I'm mostly looking for feedback on the following:

  • Are the introductory and prop descriptions useful?
  • Are we missing any descriptions for props?
  • Are we hitting the right list of best practices and limitations for each component?

Feel free to compare the pages currently in production with the new ones too!

This PR:

Linting

Improve prop descriptions + revert example desc changes

Further description improvements

Further description improvements

Further description improvements

More description improvements

Further description improvements

Description tweaks

Intro description tweaks

Revisions to limitations and best practices

Update descriptions for App Home / Admin UI Polaris components

Cherry-picked from 3c68898 with merge conflict resolution.

Updated component descriptions for ChoiceList, DateField, DatePicker, EmailField, NumberField, SearchField, TextArea, and TextField to be more concise and focused on App Home / Admin UI use cases, removing POS-specific references.

Co-authored-by: Cursor <[email protected]>

Update best practices and limitations for App Home / Admin UI Polaris components

Cherry-picked from c11d32e with merge conflict resolution.

Updated best practices and limitations sections for ChoiceList, DateField, DatePicker, EmailField, NumberField, SearchField, TextArea, and TextField components. Combined concise, focused guidance with detailed practical examples to provide comprehensive documentation that balances clarity with actionable advice.

Co-authored-by: Cursor <[email protected]>

Refinements to descriptions

ColorField + ColorPicker descriptions

DateField + DatePicker descriptions

Forms description improvements

Descriptions for layout and structure components

Media and visuals descriptions

Descriptions for Typography and content

Revert changes to Modal

Revert changes to props for Modal, Popover, DropZone, and Page

Revert accidental changes to Image and TextArea
@mcvinci mcvinci force-pushed the admin-ui-component-descriptions-2026-01 branch from a763bab to 79ab77b Compare February 5, 2026 00:47
@mcvinci mcvinci self-assigned this Feb 5, 2026
@mcvinci mcvinci added documentation Improvements or additions to documentation Admin UI Extensions Polaris web components labels Feb 5, 2026
@mcvinci mcvinci marked this pull request as ready for review February 5, 2026 01:26
@mcvinci mcvinci requested a review from SteveSill February 5, 2026 01:26
@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2026

We detected some changes in packages/*/package.json or packages/*/src, and there are no updates in the .changeset directory. If the changes are user-facing and should cause a version bump, run yarn changeset to track your changes and include them in the next release CHANGELOG. If you are making simple updates to repo configuration, examples, or documentation, you do not need to add a changeset.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Admin UI Extensions documentation Improvements or additions to documentation Polaris web components

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant