[docs] Fix 301 link to Base UI

[oliviertassinari]

Not the cleanest solution but it works to solve

https://app.ahrefs.com/site-audit/3524616/99/data-explorer?columns=pageRating%2Curl%2Ctraffic%2ChttpCode%2CredirectChainUrls%2CisRedirectLoop%2CincomingAllLinks%2CincomingRedirect%2Corigin&filterId=808b08e88c934ee19e04fdec4ed87a5a&issueId=c64d12c1-d0f4-11e7-8ed1-001e67ed4656&sorting=-pageRating

---

Extracted in #40531

Off-topic. When it comes to my own use of the components, the UX before #35938 likely work better with my workflows. Now, some would clearly prefer the new UX. Still, I think that it means that for the new approach to have a higher chance of winning, we have to fill the gaps with the older one:

1. The title of the different pages are the same. https://mui.com/base-ui/react-input/ vs. https://mui.com/base-ui/react-input/components-api/ vs. https://mui.com/base-ui/react-input/hooks-api/. This is confusing when you are looking at the results on Google. See the ones that feel much better when searching for "Slider getAriaLabel"

2. The TOCs don't sync correctly. It works in https://mui.com/material-ui/api/accordion/ but doesn't in https://mui.com/base-ui/react-switch/components-api/ (40px scroll offset bug and nested layer not synced)
3. We have translations we shouldn't have, e.g.

   material-ui/docs/translations/translations.json

   Line 305 in 48251ab

   "/base-ui/react-popup/components-api/#popup": "Popup",

4. When we rename components, we can hardly implement URL redirections because these are anchor links. We will need to invest into an anchor redirect logic.

---

Off-topic

Extracted in #40532

@alexfauquette I wonder if it would make sense to format more the HTML of the API pages, with h4, h3 so Google can more easily return relevant search results.

I have tried searching for the description of props on Google, can't really find helpful results. Maybe it's not a common workflow though, I don't recall ever trying this in the past as a user.

[mui-bot]

Netlify deploy preview

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

Bundle size report

No bundle size changes (Toolpad)
No bundle size changes

Generated by 🚫 dangerJS against 602757c

[alexfauquette]

I have tried searching for the description of props on Google, can't really find helpful results. Maybe it's not a common workflow though, I don't recall ever trying this in the past.

Just to add some information, you can search props in the algolia, and the link will let you bring you exactly on the props definition

[michelengelen]

LGTM!

[oliviertassinari]

Just to add some information, you can search props in the algolia, and the link will let you bring you exactly on the props definition

@alexfauquette The only thing I would change here is the labels, making it clear that it's an API page:

new (❌):

vs. old (✅):