[docs] Recommended Pickers styling approach shown on all styling approaches

mui / mui-x

MUI X: Build complex and data-rich applications using a growing list of advanced React components, like the Data Grid, Date and Time Pickers, Charts, and more!

https://mui.com/x/

4.01k stars 1.24k forks source link

[docs] Recommended Pickers styling approach shown on all styling approaches #13814

Open MonstraG opened 1 month ago

MonstraG commented 1 month ago

https://mui.com/x/react-date-pickers/date-picker/

Kind of issue

Broken demo

Issue description

All three styling approaches seem to be "the recommended approach":

(also true for desktop version)

Context

No response

Search keywords: recommended styling approach

LukasTy commented 1 month ago

Thank you for opening this issue. Do you find the case of multiple "Recommended" approaches to styling rather than one (best) confusing? In the case of Static Picker that is more or less the case. But for the Desktop Picker it's pretty clearly stated that theme is recommended for styling. Is there something confusing with it? 🤔

MonstraG commented 1 month ago

Do you find the case of multiple "Recommended" approaches to styling rather than one (best) confusing?

Yes, I read "Recommended" as "Best" here, because the entire page is recommendations on how to achieve certain things, that's what docs are.

I don't see any value having the same label on every approach - if everything is on discount, nothing is.

But for the Desktop Picker it's pretty clearly stated that theme is recommended for styling. Is there something confusing with it?

I did not even switch to Desktop before, and have not seen the Warning ones