-
-
Notifications
You must be signed in to change notification settings - Fork 32.4k
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
[docs] Add guides to overriding component structure in Base UI and Joy UI docs #34990
Conversation
Netlify deploy preview
Bundle size report |
@hbjORbj is working on the |
docs/data/joy/guides/overriding-component-structure/overriding-component-structure.md
Outdated
Show resolved
Hide resolved
docs/data/joy/guides/overriding-component-structure/overriding-component-structure.md
Outdated
Show resolved
Hide resolved
docs/data/joy/guides/overriding-component-structure/overriding-component-structure.md
Outdated
Show resolved
Hide resolved
docs/data/joy/guides/overriding-component-structure/overriding-component-structure.md
Show resolved
Hide resolved
docs/data/base/guides/overriding-component-structure/overriding-component-structure.md
Outdated
Show resolved
Hide resolved
docs/data/base/guides/overriding-component-structure/overriding-component-structure.md
Outdated
Show resolved
Hide resolved
update content and examples
I went ahead and changed "MUI Base" to "Base UI" in this doc. |
docs/data/joy/guides/overriding-component-structure/overriding-component-structure.md
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
👍 Looks great
…-component-structure.md Co-authored-by: Siriwat K <[email protected]> Signed-off-by: Sam Sycamore <[email protected]>
return ( | ||
<Button | ||
component="a" | ||
href="https://mui.com/about-us/" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a dead link. Fixed in #36969.
Part of #34968
This PR adds a doc on "Overriding component structure" to the How To Guide sections of the MUI Base and Joy UI docs.
As I was writing the main text, I realized that it only really makes sense if you have an accurate mental model of the components and understand the terminology we use, so I tried to introduce these concepts as succinctly as possible in the intro.
The content of the two docs is essentially the same. I added a link to the Joy UI page to explain that Joy will automatically correct semantically inappropriate HTML.
We could also add this guide to the Material UI docs, but these props are not consistently available to components in that library (yet), so I wasn't sure how to approach this. Maybe it's best to wait to introduce these props in the Material UI docs.
Ideally these docs will describe everything that a user needs to know on this topic. Once they're published, then we can decide whether or not to move/remove these details from the Component pages in Base and Joy where they're present.