[core] Replace relative links to absolute ones in JSDocs

[alexfauquette]

Follow up of #42472

Restart of #42528 to get a clearer commit history.

would use full URLs to the stable API for the .d.ts files. We use relative URLs for the link on the docs pages. It's not perfect, but it's still better than what we have today, so a step forward to improving the DX.

#42528 (comment)

After this PR links in all props should have an absolut link to the docs, allowing user to click on them from their IDE

[mui-bot]

Netlify deploy preview

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

Bundle size report

No bundle size changes (Toolpad)
No bundle size changes

Generated by 🚫 dangerJS against 3960692

[DiegoAndai]

@alexfauquette a couple of questions:

• Is there a way to test that this doesn't break in the future?
• How should we deal with new major versions in the future? for example, when v7 is released, the v6 docs should be modified mui.com -> v6.mui.com

[alexfauquette]

Is there a way to test that this doesn't break in the future?

Not really. It's like a standard. People writing links in JSDocs look at how other links are done. And so if they see all links starting with https://mui.com they will do the same.

For the docs aspect, we could check the links looking for xxx.mui.com and making sure all the xxx are coherent.

How should we deal with new major versions in the future? for example, when v7 is released, the v6 docs should be modified mui.com -> v6.mui.com

When doing a major you would have two steps:

1. When creating the next branch should do a "find and replace replace" as follow: ://mui.com -> ://next.mui.com
2. When moving master to v6 do ://mui.com -> ://v6.mui.com
3. When renaming next to master do ://next.mui.com -> ://mui.com

[DiegoAndai]

Thanks @alexfauquette!

[DiegoAndai]

When doing a major you would have two steps:

I added this to our major release guide

[oliviertassinari]

Nice, a step forward

[oliviertassinari]

In the future, I think that we want to automatically remove https://mui.com/ from those links to have relative URLs.