-
-
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] Improve the Getting Started documentation content #30808
[docs] Improve the Getting Started documentation content #30808
Conversation
mnajdova
commented
Jan 27, 2022
- I have followed (at least) the PR section of the contributing guide.
@@ -177,10 +177,6 @@ const StyledSlider = styled(Slider, { | |||
|
|||
{{"demo": "pages/customization/how-to-customize/DynamicCSSVariables.js"}} | |||
|
|||
### Theme nesting |
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.
We shouldn't recommend using nested themes for changing the look of the component based on prop. It is misleading. The nested theme has a different purpose, and it is described on different pages.
@@ -225,7 +221,3 @@ If you are already using the [CssBaseline](/components/css-baseline/) component | |||
) | |||
} | |||
``` | |||
|
|||
## 6. Custom class name |
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.
It's not relevant here.
}, | ||
}); | ||
``` | ||
Think of creating a theme as a two-step composition process: first, you define the basic design options; then, you'll use these design options to compose other options. |
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.
We support now callbacks in the styleOverrides
this is not an issue anymore.
@@ -52,6 +52,7 @@ If you want to start with a more complete and real-world example, you could take | |||
- All PWA features included (SW, Notifications, deferred installation prompt and more) | |||
- Optimized and scalable performance (all ~100 points on Lighthouse) | |||
|
|||
<!-- TODO: revert this once it is migrated to v5 |
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.
It's still using v4, we should not link it until it is upgraded. It is misleading for people first coming to the documentaiton.
|
||
<!-- TODO: revert this once it is migrated to v5 |
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.
Same here, still depends on v4.
- [Material Sense](https://github.com/alexanmtz/material-sense): | ||
|
||
- ![stars](https://img.shields.io/github/stars/alexanmtz/material-sense.svg?style=social&label=Star) | ||
- Graph using recharts | ||
- React Router included with a navigation example | ||
- A docker container with an Nginx server for production build | ||
- Created with Create React App | ||
|
||
- [RMUIF](https://github.com/rmuif/web): |
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.
Not maintained anymore, depends on v4.
@@ -20,6 +20,8 @@ This [selection of basic templates](/getting-started/templates/) will help you g | |||
|
|||
## Recommended resources | |||
|
|||
> ⚠️ Note that the resources linked below are using MUI v4, which is not the latest major version. As v5 was released recently, it would take some time till new content is created. If you have created some learning material for v5, let us know and we can link them here. |
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.
Hopefully we will have more content related to v5 soon
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.
Apart from my comment, other things look good to me 👍
Co-authored-by: Benny Joo <[email protected]>
Co-authored-by: Benny Joo <[email protected]>
Co-authored-by: Benny Joo <[email protected]>