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

[material-ui][docs] Standardize all references to Material Design 3 (M3) #40903

Merged
merged 20 commits into from
Feb 15, 2024

Conversation

samuelsycamore
Copy link
Member

@samuelsycamore samuelsycamore commented Feb 2, 2024

Raised in this comment thread: #40446 (comment)

m3
(From https://developer.android.com/codelabs/jetpack-compose-theming#0)

This PR replaces mentions of "Material 3" and "MD3" with either "Material Design 3" or "M3."

Though "Material 3" might be considered an acceptable synonym, I think it's overly confusing in our context. (Are we talking about Material UI v3?). We should err on the side of clarifying that we're talking about Material Design most of the time; after first mention, I think M3 works well to maintain that clarity.

I removed the names of the components from the headers in the component demo docs because they just felt redundant. The search experience could be better, but that's something we should address with the design of the search results if we want to improve it.

I've also done some rewriting of the @mui/material-next docs to reflect the changes to the release schedule (since M3 is coming in v7, not v6).

@samuelsycamore samuelsycamore added the docs Improvements or additions to the documentation label Feb 2, 2024
@samuelsycamore samuelsycamore changed the title [material-ui][docs] Standardize all references to Material Design 3 [material-ui][docs] Standardize all references to Material Design 3 (M3) Feb 2, 2024
@samuelsycamore
Copy link
Member Author

samuelsycamore commented Feb 2, 2024

The @mui/material-next codebase uses "Material You" and "MD3" throughout—should we standardize these as well? (I don't like "Material You" personally, because it's a nightmare to try to have a spoken conversation about "Material UI's implementation of Material You." 🙃)

Copy link
Member

@DiegoAndai DiegoAndai left a comment

Choose a reason for hiding this comment

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

Thanks for tackling this @samuelsycamore 😊

Regarding "Material You" and "MD3" mentions in @mui/material-next, we should standardize them as well.

Copy link
Contributor

@danilo-leal danilo-leal left a comment

Choose a reason for hiding this comment

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

Looks great to me! 🤙

@danilo-leal danilo-leal added the package: material-ui Specific to @mui/material label Feb 5, 2024
@oliviertassinari
Copy link
Member

Nice 👍

@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged label Feb 6, 2024
@github-actions github-actions bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged label Feb 12, 2024
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 package: material-ui Specific to @mui/material
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants