You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"Example projects" as a header doesn't make sense to me. These are more specific
We are missing integration examples
We don't have a detailed guide on how to integrate with each. If you have an existing project, you have to go to the examples to figure it out by yourself, this sucks.
i. link the showcase too. The whole point of this page is to give people examples they can get inspiration from.
ii. update "Official examples" to remove this section or point to page 1, since people might land on this page without having seen the integration yets.
iv. add cool project examples that we can find, assuming that 6.i. isn't enough. Like I could see how having a link to the showcase with open-source project would do the job well.
the React-admin and Refine examples should be moved under a general integration docs area https://mui.com/material-ui/integrations/routing/ since they are not needed to get started, it feels more common to add them to an existing project.
That general integration docs area should also reference the framework integration so they can be seen as a catalog of all the integrations available, useful as a marketing asset to convince developers.
Motivation 🔦
Improve the onboarding experience, which is critical in the journey of developers.
The text was updated successfully, but these errors were encountered:
Problems 💡
I think we must rework the whole section of https://mui.com/material-ui/getting-started/example-projects/. It's not great:
Proposal
Create a new Integration page alongside https://mui.com/material-ui/getting-started/example-projects/ under the getting started area of the docs. Cover all the integrations with the framework that are relevant. We have another Integration section in https://mui.com/material-ui/integrations/routing/ but are a bit different, you don't need those to get started.
Have an example and a step-by-step guide on how to configure each integration. Mantine is one that embodies the best proposal, e.g. https://mantine.dev/guides/remix/. https://tailwindcss.com/docs/installation/framework-guides is nice but is missing examples. This is also great when you start and need to rely on two integrations, e.g. Next.js + Tailwind CSS.
Move https://mui.com/material-ui/integrations/nextjs/ to be hosted under 1. since it's required to get started. Same for https://mui.com/joy-ui/integrations/next-js-app-router/.
Add the missing framework integration
In https://mui.com/material-ui/getting-started/example-projects/, I think we should:
i. link the showcase too. The whole point of this page is to give people examples they can get inspiration from.
ii. update "Official examples" to remove this section or point to page 1, since people might land on this page without having seen the integration yets.
iv. add cool project examples that we can find, assuming that 6.i. isn't enough. Like I could see how having a link to the showcase with open-source project would do the job well.
the React-admin and Refine examples should be moved under a general integration docs area https://mui.com/material-ui/integrations/routing/ since they are not needed to get started, it feels more common to add them to an existing project.
That general integration docs area should also reference the framework integration so they can be seen as a catalog of all the integrations available, useful as a marketing asset to convince developers.
Motivation 🔦
Improve the onboarding experience, which is critical in the journey of developers.
The text was updated successfully, but these errors were encountered: