[docs][select] `placeholder` prop is omitted

[thany]

Related page

https://mui.com/material-ui/api/select/

Kind of issue

Missing information

Issue description

Following issue #44502, the placeholder prop has been removed from the Select component for having no effect. While I'm inclined to disagree (MUI could render a placeholder, and the Select documentation event suggests on how to render one) the API documentation should at least reflect that decision.

As of the time of writing, the Select API documentation makes no mention of the omission of the placeholder prop. In fact, it refers to OutlinedInput:

Props of the OutlinedInput component are also available.

Which is where it is rightfully listed, leading developers to believe it should be available in Select.

I was ready to file a bug report, but having found that issue, I discovered placeholder was omitted intentionally. At first I went to the documentation to figure out what's what with this prop, but no mention of it was made, which lead me to create the issue you're reading now.

Context

No response

Search keywords: select placeholder

[aarongarciah]

@thany thanks for reporting! We should update the docs to reflect this.

[aarongarciah]

#44856 updated the Select docs page with a callout to point out that the placeholder prop is not available in Select.

The Select API docs page still needs to be updated, but it probably requires some docs infra work as the info for what props from the component it inherits from are part of an abstraction: https://mui.com/material-ui/api/select/#props