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] Update links and sidebar nav for Base UI components in Material UI #44581

Merged
merged 11 commits into from
Dec 3, 2024

Conversation

samuelsycamore
Copy link
Contributor

Follow-up to #41961

  • adds deprecated chips to the sidebar nav for the 4 Base UI components included in Material UI (suggested in this comment - I'm on the fence about it so I'm curious what others think)
  • updates copy on the "This document has moved" pages
  • points internal links away from Material UI to the actual Base UI docs so users don't have to click twice

@samuelsycamore samuelsycamore added the docs Improvements or additions to the documentation label Nov 27, 2024
@samuelsycamore samuelsycamore marked this pull request as ready for review November 27, 2024 21:33
Copy link
Member

@aarongarciah aarongarciah left a comment

Choose a reason for hiding this comment

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

Nice


adds deprecated chips to the sidebar nav for the 4 Base UI components included in Material UI (suggested in this comment - I'm on the fence about it so I'm curious what others think)

Since these components are deprecated, I think it makes sense to mark them as deprecated.

@@ -44,8 +44,8 @@ The `helperText` prop can then be used to provide feedback to the user about the

## Multiline

The `multiline` prop transforms the text field into a [TextareaAutosize](/material-ui/react-textarea-autosize/) element.
Unless the `rows` prop is set, the height of the text field dynamically matches its content (using [TextareaAutosize](/material-ui/react-textarea-autosize/)).
The `multiline` prop transforms the Text Field into a [Base UI Textarea Autosize](/base-ui/react-textarea-autosize/) element.
Copy link
Member

Choose a reason for hiding this comment

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

off-topic: I find this convention weird. As a user I always prefer to read the actual component name:

  • "TextField" vs "Text Field"
  • "TextareaAutosize" vs "Textarea Autosize"
  • "ClickAwayListener" vs "Click-Away Listener"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Interesting. This was a style convention we adopted a few years ago to try to help improve readability as I recall. But if it's not actually helping then maybe we should consider re-evaluating it as an org.

@samuelsycamore samuelsycamore merged commit ffbd703 into mui:master Dec 3, 2024
22 checks passed
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