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

Add MenuGroup design documentation #14466

Merged
merged 2 commits into from
Mar 15, 2019
Merged

Add MenuGroup design documentation #14466

merged 2 commits into from
Mar 15, 2019

Conversation

kjellr
Copy link
Contributor

@kjellr kjellr commented Mar 15, 2019

This PR adds design guideline documentation for the MenuGroup component, in addition to the development documentation that existed previously. These guidelines are 'best practices' for the usage of the component, as well as describing the component in more detail.

The new README can be previewed here:
https://github.com/WordPress/gutenberg/blob/a264af53c440a025d697da11b6c1de84136cdb48/packages/components/src/menu-group/README.md

@kjellr kjellr added [Type] Developer Documentation Documentation for developers Needs Design Feedback Needs general design feedback. labels Mar 15, 2019
@kjellr kjellr self-assigned this Mar 15, 2019
@kjellr kjellr added this to the Documentation & Handbook milestone Mar 15, 2019
@kjellr kjellr changed the title Add ButtonGroup design documentation Add MenuGroup design documentation Mar 15, 2019
Copy link
Member

@karmatosed karmatosed left a comment

Choose a reason for hiding this comment

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

Great, thanks. Approving as we can always iterate these but really good to get in.

Copy link
Contributor

@davewhitley davewhitley left a comment

Choose a reason for hiding this comment

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

Just some non-blocking suggestions.


### Usage

A `MenuGroup` should be used to indicate that two or more individual MenuItems are related. When other menu items exist above or below a `MenuGroup`, the group should have a divider line between it and the adjacent item. A MenuGroup can optionally include a label to describe its contents.
Copy link
Contributor

Choose a reason for hiding this comment

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

No tick marks around MenuGroup for some reason

Suggested change
A `MenuGroup` should be used to indicate that two or more individual MenuItems are related. When other menu items exist above or below a `MenuGroup`, the group should have a divider line between it and the adjacent item. A MenuGroup can optionally include a label to describe its contents.
A `MenuGroup` should be used to indicate that two or more individual MenuItems are related. When other menu items exist above or below a `MenuGroup`, the group should have a divider line between it and the adjacent item. A `MenuGroup` can optionally include a label to describe its contents.

Should "MenuItems" have tick marks?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yep, it should. Good catch! I've opened #14490 as a quick fix for that. 🙂


![MenuGroup diagram with label and dividers](https://wordpress.org/gutenberg/files/2019/03/MenuGroup-Anatomy.png)

1. MenuGroup label
Copy link
Contributor

Choose a reason for hiding this comment

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

"MenuGroup" may be redundant, but it is a bit more clear since you mention other components above. I'll leave that up to you.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yeah, I think it's fine to repeat that there, for clarity's sake. Those should have tick marks like the other mentions of the components though. 👍

@karmatosed karmatosed merged commit 6f7fc09 into master Mar 15, 2019
@youknowriad youknowriad deleted the update/menugroup-readme branch March 16, 2019 07:43
youknowriad pushed a commit that referenced this pull request Mar 20, 2019
* Update MenuGroup Readme.

Add design guidelines and screenshots.

* Adjust introduction to be more concise.
youknowriad pushed a commit that referenced this pull request Mar 20, 2019
* Update MenuGroup Readme.

Add design guidelines and screenshots.

* Adjust introduction to be more concise.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Needs Design Feedback Needs general design feedback. [Type] Developer Documentation Documentation for developers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants