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

[EUI+] Split up several component pages into subpages #8181

Merged
merged 9 commits into from
Nov 25, 2024

Conversation

cee-chen
Copy link
Member

@cee-chen cee-chen commented Nov 23, 2024

Summary

The primary goal of this PR is making certain very long component doc pages more readable/dev-friendly, and also not have a million props tables in a row (EuiButton is the primary culprit of this).

If you have any other suggestions for components that would benefit from more subpages, feel free to throw them into this PR! (or we can open other follow up PRs!)

QA

Check that the following docs pages and their copy/examples/props table generally work and look sane:

General checklist

N/A, docs only

- makes props tables significantly easier to grok

+ restore button cards at top of main button intro
@cee-chen cee-chen added documentation Issues or PRs that only affect documentation - will not need changelog entries skip-changelog labels Nov 23, 2024
@cee-chen cee-chen marked this pull request as ready for review November 23, 2024 07:08
@cee-chen cee-chen requested a review from a team as a code owner November 23, 2024 07:08
+ add EuiSplitPanel props
- it's one of our most used (and sometimes most misused) components, so we might as well spend more time here

- flex usage has also changed somewhat since the docs were first written (we use `gap` now instead of negative margins, and flex grid uses CSS grid instead of flexbox), so some of this copy needed updating
@kibanamachine
Copy link

Preview staging links for this PR:

@elasticmachine
Copy link
Collaborator

💚 Build Succeeded

History

Copy link
Contributor

@weronikaolejniczak weronikaolejniczak left a comment

Choose a reason for hiding this comment

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

Amazing job! 🎉 Went through all the changes, didn't notice any issues or typos, also couldn't think of any other page that might need this reorg 🤔 I especially like the Button page division, it's much cleaner now, since ButtonEmpty, ButtonGroup and ButtonIcon are completely separate but their prop tables made the page quite long.

I'm leaving an approve but feel free to ping anybody else for a review in case you want additional feedback 😄

Btw I created a task for this under the meta issue: #8163

@cee-chen
Copy link
Member Author

Thanks a million Weronika!! I feel good merging this in with just one review since it's a docs-only change, and we can keep improving/tweaking them over time.

@cee-chen cee-chen merged commit 9eb944a into elastic:main Nov 25, 2024
5 checks passed
@cee-chen cee-chen deleted the website/reorg-1 branch November 25, 2024 16:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Issues or PRs that only affect documentation - will not need changelog entries skip-changelog
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants