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] Link Material UI from the landing page #37971

Merged
merged 2 commits into from
Jul 18, 2023

Conversation

oliviertassinari
Copy link
Member

@oliviertassinari oliviertassinari commented Jul 14, 2023

Problem

Take https://search.google.com/search-console/performance/search-analytics, developers were quick to jump into the opportunity to replace their search for "material ui" to "mui", I imagine because it's faster to type:

Screenshot 2023-07-15 at 01 02 45

Noooo

Solution

  1. Make landing on https://mui.com/material-ui/ from Google a faster way to reach Material UI docs than landing on https://mui.com/. So reduce the advantage of the shorter "mui" search query over typing "material ui".
  2. Break the narrative of MUI homepage hosting the installation instructions of Material UI
Screenshot 2023-07-15 at 00 55 10

Preview: https://deploy-preview-37971--material-ui.netlify.app/

It will be even better with #37608

@oliviertassinari oliviertassinari added docs Improvements or additions to the documentation package: material-ui Specific to @mui/material labels Jul 14, 2023
@mui-bot
Copy link

mui-bot commented Jul 14, 2023

Netlify deploy preview

https://deploy-preview-37971--material-ui.netlify.app/

Bundle size report

No bundle size changes (Toolpad)
No bundle size changes

Generated by 🚫 dangerJS against f55587e

@danilo-leal
Copy link
Contributor

It will be even better with #37608

@oliviertassinari were you thinking of linking the Core page instead? Something like "Discover the Core products"?

@oliviertassinari
Copy link
Member Author

Were you thinking of linking the Core page instead? Something like "Discover the Core products"?

@danilo-leal Not necessarily but it sounds like a good option. Do you have a preference?

@danilo-leal
Copy link
Contributor

It's tricky as we don't have anything immediately better to link to, but maybe directing to the Core page is better than having the main call to action of the homepage directing to the Material UI docs, which, to me, only reinforces the "MUI equals to Material UI" confusion.

Definitely looking forward to revamping the homepage soon so it better exposes everything we have to offer and then possibly coming up with another destination for the main cta but, for the time being, maybe that's a bit better? It doesn't necessarily make getting to the Material UI docs faster, though.

@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged label Jul 18, 2023
@github-actions github-actions bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged label Jul 18, 2023
Copy link
Contributor

@danilo-leal danilo-leal left a comment

Choose a reason for hiding this comment

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

Looks good to me! 🤙

@oliviertassinari oliviertassinari merged commit e4dc06a into mui:master Jul 18, 2023
@oliviertassinari oliviertassinari deleted the isolate-landing-page branch July 18, 2023 12:44
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 package: material-ui Specific to @mui/material
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants