[docs] Product onboarding content architecture #16586
Labels
discussion
dx
Related to developers' experience
new feature
New feature or request
umbrella
For grouping multiple issues to provide a holistic view
Summary
I have been pushing lately for the following docs architecture, taking this from the angle of customers:
Those pages are shown at the root URL, e.g. https://mui.com/x/react-data-grid/, https://mui.com/x/react-charts/ but use the same layout as the marketing page, e.g. https://mui.com/x/. They don't use the layout of the docs. I think it's really important because those pages in the docs are annoying from the perspective of a regular user, at least, it's how I experienced https://mui.com/x/react-date-pickers/ so far, pain.
If the content requires depth to pick the right component, e.g. pickers for birthday, chart type based on what needs to be shown https://flourish.studio/blog/choosing-the-right-visualisation/, then it might not be wise to have the depth in the overview page, but best to move it to a guide page.
This page is not as detailed as the docs, so not as overwhelming, but goes more into the details than the marketing or overview page, when you want to learn more to either see proofs or figure out what you need.
I'm curious about collecting thoughts on this. What if we were to execute it?
Search keywords: -
cc @mapache-salvaje
The text was updated successfully, but these errors were encountered: