Skip to content
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

Toggle doc updates #4214

Merged
merged 30 commits into from
Aug 29, 2024
Merged

Toggle doc updates #4214

merged 30 commits into from
Aug 29, 2024

Conversation

alina-jacob
Copy link
Member

@alina-jacob alina-jacob commented Aug 23, 2024

Closes #3065 and #4227

New

[Usage Tab]

  • Added Overview image.
  • Added content and image for Anatomy section.
  • Added content and image supporting small toggle with action text.
  • Added general additional content referring to the Usage tab docs.

[Style Tab]

  • Added Page description, Anchorlinks and Feedback section

Changed

[Usage Tab]

  • Replaced the Interactive states image with a table.
  • Updated the variant image (label to component spacing)
  • Clarified guidance around optional elements across Toggle variants.

[Style Tab]

  • Updated the component color and interactive color image.
  • Updated the toggle spec and toggle sizes images (label to component spacing)

Removed

[Usage Tab]

  • Removed the interactive states image and replaced it with a table.

General

  • Updated all existing and new images to have the correct label to component spacing.

Copy link

vercel bot commented Aug 23, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
carbondesignsystem ✅ Ready (Inspect) Visit Preview 💬 Add feedback Aug 29, 2024 2:43pm

Copy link
Member

@thyhmdo thyhmdo left a comment

Choose a reason for hiding this comment

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

Looks great! In general, default and small variants don't need to be capitalized within the sentence

src/pages/components/toggle/images/toggle-style-states.png Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
alina-jacob and others added 5 commits August 26, 2024 20:44
Co-authored-by: thyhmdo <77697351+thyhmdo@users.noreply.github.com>
Co-authored-by: thyhmdo <77697351+thyhmdo@users.noreply.github.com>
Co-authored-by: thyhmdo <77697351+thyhmdo@users.noreply.github.com>
Co-authored-by: thyhmdo <77697351+thyhmdo@users.noreply.github.com>
Co-authored-by: thyhmdo <77697351+thyhmdo@users.noreply.github.com>
Copy link
Member

@laurenmrice laurenmrice left a comment

Choose a reason for hiding this comment

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

Hey Alina! Looking good, ⭐️ just some grammatical things to fix. I also have left some comments about images in your Figma file.

src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/style.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/style.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/style.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/style.mdx Outdated Show resolved Hide resolved
Copy link
Contributor

@Kritvi-bhatia17 Kritvi-bhatia17 left a comment

Choose a reason for hiding this comment

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

Hi Alina! Great work, just a few minor typos and fixes.

src/pages/components/toggle/style.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/style.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/style.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
alina-jacob and others added 6 commits August 26, 2024 23:56
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
alina-jacob and others added 3 commits August 28, 2024 14:40
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Copy link
Contributor

@guidari guidari left a comment

Choose a reason for hiding this comment

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

LGTM!

Copy link
Member

@laurenmrice laurenmrice left a comment

Choose a reason for hiding this comment

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

Looking good @alina-jacob ✨ Just a couple more things! Some of these were reviewed previously and were not fixed, so I added them again! I think they might have gotten lost in the collapsible buckets.

src/pages/components/toggle/usage.mdx Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
src/pages/components/toggle/usage.mdx Outdated Show resolved Hide resolved
@laurenmrice
Copy link
Member

First style structure image
For your first style structure image, I would just extend the teal padding container/lines to the right more to hit where the text ends (like in your second structure image) so they are consistent. I added a red line here to show to extend it to that.

Screenshot 2024-08-28 at 5 42 55 PM

alina-jacob and others added 4 commits August 29, 2024 11:54
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Co-authored-by: Lauren Rice <43969356+laurenmrice@users.noreply.github.com>
Copy link
Member

@laurenmrice laurenmrice left a comment

Choose a reason for hiding this comment

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

Looks good, Alina!

Copy link
Contributor

@Kritvi-bhatia17 Kritvi-bhatia17 left a comment

Choose a reason for hiding this comment

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

Looks good to me Alina! Great work ✨🔥
(Just one last very minor typo)

@@ -57,7 +77,7 @@ tabs: ['Usage', 'Style', 'Code', 'Accessibility']
</Column>
</Row>

<Caption>Interactive toggle states</Caption>
<Caption>Interactive toggle states.</Caption>
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
<Caption>Interactive toggle states.</Caption>
<Caption>Interactive toggle states</Caption>

@kodiakhq kodiakhq bot merged commit e71ad45 into carbon-design-system:main Aug 29, 2024
7 checks passed
@Kritvi-bhatia17
Copy link
Contributor

Hi @alina-jacob! I just noticed that the "Variants" heading should be H3 instead of H2. For more information, you can refer to the Pagination Usage doc, which is the most recent update. I just noticed this and thought of mentioning it. If you could fix this minor issue in your Menu button PR, that would be great, but if not, we can fix it later. Thank you!

Screenshot 2024-09-02 at 2 02 34 PM

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

Successfully merging this pull request may close these issues.

Toggle: Usage and Style documentation
6 participants