[docs] Automatic title and meta description

[vladmoroz]

• I have followed (at least) the PR section of the contributing guide.

[mui-bot]

Netlify deploy preview

https://deploy-preview-863--base-ui.netlify.app/

Generated by 🚫 dangerJS against a67a57c

[michaldudak]

AFAIR, we wanted to have a richer title than just the title for SEO purposes ("React Dialog component" instead of just "Dialog")

[vladmoroz]

Hmm I think short titles are a much better experience for the end user.

---

I see MUI docs do that, but I'm not a fan of how messy opening a bunch of tabs from mui.com feels

[michaldudak]

I agree. It does look better in the browser's tabs.
@oliviertassinari, I remember you were suggesting richer titles in the past. Any opinions on this?

[colmtuite]

We can put the SEO juice in the url

url: /react-component-name
pageTitle: Component name • Base UI

[vladmoroz]

We've agreed on the following for titles and URLs:

Dialog • Base UI
https://base-ui.com/react/dialog

Bonus, URLs are going to match import paths:

// When we do kebab-casing
import { Dialog } from "@base-ui-components/react/dialog"

// Eventually
import { Dialog } from "@base-ui/react/dialog"

[oliviertassinari]

I remember you were suggesting richer titles in the past. Any opinions on this?

@michaldudak Right, so why do the pages of MUI follow those patterns?

• On the SEO side, if we can trust Moz.com (account), it's a ranking factor. Because

Source: https://analytics.moz.com/pro/analytics/analyze-keyword/15825137/2871441/9c418058312a1f68ac62edaa1217a2bc

• On the UX side, we could change the title after the page is rendered? Google still renders pages in JS, so the solution might be to detect multiple tabs: https://stackoverflow.com/questions/9576851/detect-presence-of-other-tabs-windows-of-same-domain. If there are multiple tabs, we can use the short titles, Google won't see them. UX is improved, SEO is maximized.

Personally, I work with a small screen, my tabs are very quickly cut, I can't read them most of the time, I have learned to live without tab titles, so that's why I didn't bother so much. Or maybe it was because I always felt that onboarding is critical considering the duration developers stick to a specific stack. If someone helps win more new % users, and it's not annoying enough for them to leave, then it helps win in the long term?

We can wait to see how those pages rank. I will be curious to see. I'm creating an issue with this idea: mui/mui-public#251.