Skip to content

docs(b and c components): consistent api description refs #8536

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Jan 3, 2024

Conversation

DitwanP
Copy link
Contributor

@DitwanP DitwanP commented Jan 2, 2024

Related Issue: #7071

Summary

Updates doc consistency across b and c-named components defined in the above issue for props, events, methods, and css vars, including:

  • button
  • block
  • block-section
  • color-picker-hex-input
  • color-picker
  • combobox

cc @geospatialem

@github-actions github-actions bot added the docs Issues relating to documentation updates only. label Jan 2, 2024
…into dit13711/7071-update-api-reference-descriptions
@DitwanP DitwanP added the skip visual snapshots Pull requests that do not need visual regression testing. label Jan 2, 2024
Copy link
Member

@geospatialem geospatialem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! ✨ 🧹 ✨

Have a few considerations for your review below.

* Specifies the default behavior of the button.

For consistency, we should rename any named components, something like:

Specifies the default behavior of the button component.

/** Specifies the selection mode of the component. */
@Prop({ reflect: true }) selectionMode: Extract<
"multiple" | "single" | "single-persist" | "none",
SelectionMode
> = "none";

Could we add some context to the selection mode types, similar to list?

/** Specifies the name of the component on form submission. */
@Prop({ reflect: true }) name: string;

WDYT about adding in context to the name prop, similar to combobox?

@DitwanP DitwanP marked this pull request as ready for review January 2, 2024 22:39
@DitwanP DitwanP requested a review from a team as a code owner January 2, 2024 22:39
@DitwanP DitwanP requested a review from geospatialem January 2, 2024 22:39
Copy link
Member

@geospatialem geospatialem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for working through these! 🙌🏻 Two small considerations from some duplicative styling where the prop values are summarized.

@DitwanP DitwanP requested a review from geospatialem January 3, 2024 17:29
Copy link
Member

@geospatialem geospatialem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome! 🥇

@DitwanP DitwanP merged commit cda5093 into main Jan 3, 2024
@DitwanP DitwanP deleted the dit13711/7071-update-api-reference-descriptions branch January 3, 2024 20:04
@github-actions github-actions bot added this to the 2024-01-17 - Jan Main Release milestone Jan 3, 2024
benelan added a commit that referenced this pull request Jan 4, 2024
…-not-internal

* origin/main:
  docs(d, f, g, and h-named components): update api description refs (#8540)
  docs(b and c components): consistent api description refs (#8536)
  ci(update-doc): build design tokens to prevent errors (#8542)
  docs: update component readmes (#8543)
  ci: consistent formatting across packages (#8534)
  refactor(list-item): Remove unnecessary code for rendering open caret (#8537)
  docs(tab-nav, table, tabs, tile-select, tree, value-list): consistent api description refs (#8535)
  chore: release next
  feat(list-item): Add dragSelected property and calciteListItemDragHandleChange event (#8524)
  chore: release next
  fix(input-date-picker): hard to reproduce numbering-system caching issue (#8518)
  feat(handle): add selected property and calciteHandleChange event. (#8484)
  docs(action-bar, action-group, action-pad, alert): consistent api decription refs (#8533)
benelan added a commit that referenced this pull request Jan 4, 2024
…idation-ui

* origin/main:
  docs(d, f, g, and h-named components): update api description refs (#8540)
  docs(b and c components): consistent api description refs (#8536)
benelan added a commit that referenced this pull request Jan 5, 2024
…mber-infinity

* origin/main:
  refactor: remove @ts-ignore needed for Stencil missing  in JSX types (#8551)
  refactor(combobox): remove unused interface (#8552)
  fix(input-date-picker): ensure range icon toggles open corresponding date-picker (#8554)
  fix(button): avoid needlessly overwriting title (#8491)
  docs(d, f, g, and h-named components): update api description refs (#8540)
  docs(b and c components): consistent api description refs (#8536)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Issues relating to documentation updates only. skip visual snapshots Pull requests that do not need visual regression testing.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants