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

Feat: Storybook: Improve component organisation - Navigation Category - Issue #66275 #66658

Merged
merged 4 commits into from
Nov 7, 2024

Conversation

hbhalodia
Copy link
Contributor

What?

Why?

This change is part of the larger Storybook Improvements and the shared Sitemap.

How?

Adding Categories that helps organize and group components into sections based on their role and function within the library makes our library easier to navigate and understand.

Testing Instructions

  1. Checkout to the PR.
  2. Run npm run storybook:dev.
  3. Check for the updated components with category that are changed in PR.

Testing Instructions for Keyboard

  • None

Screenshots or screencast

Screenshot 2024-11-01 at 9 25 55 AM Screenshot 2024-11-01 at 9 26 00 AM

@hbhalodia hbhalodia requested a review from ajitbohra as a code owner November 1, 2024 03:56
@hbhalodia hbhalodia requested a review from a team November 1, 2024 03:56
Copy link

github-actions bot commented Nov 1, 2024

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: hbhalodia <[email protected]>
Co-authored-by: tyxla <[email protected]>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@hbhalodia hbhalodia changed the title Feat: Storybook: Improve component organisation - Navigation Catrgory - Issue #66275 Feat: Storybook: Improve component organisation - Navigation Category - Issue #66275 Nov 1, 2024
Copy link
Member

@tyxla tyxla 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 your work here @hbhalodia! 🙌

Just like in #66657 there are a few considerations for experimental components we might need to consider before shipping.

Also, I'd like to double-check if we really want to put "Tabs" into the Navigation category. My expectation is that it's better suited to live in Containers instead.

packages/components/src/tabs/stories/index.story.tsx Outdated Show resolved Hide resolved
@@ -16,7 +16,8 @@ import { Button } from '../../button';
import InputControl from '../../input-control';

const meta: Meta< typeof TreeGrid > = {
title: 'Components (Experimental)/TreeGrid',
title: 'Components (Experimental)/Navigation/TreeGrid',
Copy link
Member

Choose a reason for hiding this comment

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

Another thing (cc @ciampo @mirka): experimental components will fall in their own section down below, meaning they will have their own Navigation directory. Is that desired? Should we consider marking the experimental components just with badges, like CustomSelectControlV2 is marked WIP?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

experimental components will fall in their own section down below, meaning they will have their own Navigation directory.

Waiting on this until confirmation of above.

Cc: @tyxla

Copy link
Member

Choose a reason for hiding this comment

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

I've been discussing this with @ciampo, and we concluded that it's a problem that can be solved separately.

In the future we may remove the "Experimental" distinction from the Storybook component list, and those categories that we're introducing will be on the top level. That being said, we could leave things as they are and ship this PR, and I've opened #66805 to discuss this separately.

packages/components/src/tree-grid/stories/index.story.tsx Outdated Show resolved Hide resolved
@tyxla tyxla added [Type] Developer Documentation Documentation for developers [Package] Components /packages/components Storybook Storybook and its stories for components labels Nov 7, 2024
Copy link
Member

@tyxla tyxla left a comment

Choose a reason for hiding this comment

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

LGTM, thanks again @hbhalodia 🙌

@tyxla tyxla merged commit 20b773b into WordPress:trunk Nov 7, 2024
63 of 64 checks passed
@github-actions github-actions bot added this to the Gutenberg 19.7 milestone Nov 7, 2024
karthick-murugan pushed a commit to karthick-murugan/gutenberg that referenced this pull request Nov 13, 2024
… - Issue WordPress#66275  (WordPress#66658)

* Group the storybook components in Navigaiton category

* Fix tabs to add inside containers and add experimental id for component

* Fix the syntax style

Co-authored-by: hbhalodia <[email protected]>
Co-authored-by: tyxla <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Package] Components /packages/components Storybook Storybook and its stories for components [Type] Developer Documentation Documentation for developers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants