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

[docs] Improve the Getting Started documentation content #30808

Merged

Conversation

mnajdova
Copy link
Member

@@ -177,10 +177,6 @@ const StyledSlider = styled(Slider, {

{{"demo": "pages/customization/how-to-customize/DynamicCSSVariables.js"}}

### Theme nesting
Copy link
Member Author

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
Copy link
Member Author

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.
Copy link
Member Author

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
Copy link
Member Author

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
Copy link
Member Author

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):
Copy link
Member Author

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.
Copy link
Member Author

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

@mnajdova mnajdova added the docs Improvements or additions to the documentation label Jan 27, 2022
@mui-bot
Copy link

mui-bot commented Jan 27, 2022

No bundle size changes

Generated by 🚫 dangerJS against ce3e8fc

@mnajdova mnajdova marked this pull request as ready for review January 27, 2022 16:26
Copy link
Member

@siriwatknp siriwatknp left a 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 👍

@mnajdova mnajdova merged commit 6b66d1b into mui:master Jan 31, 2022
wladimirguerra pushed a commit to wladimirguerra/material-ui that referenced this pull request Feb 2, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to the documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants