[docs] template links broken

[Nef10]

Duplicates

• I have searched the existing issues

Latest version

• I have tested the latest version

Current behavior 😯

The Source Code links on https://mui.com/getting-started/templates/ result in a 404 page.

Expected behavior 🤔

With PR #30757 the files have moved. While the path in the docs was adjusted, it is not deployed yet. It is annotated with #default-branch-switch, however the current version links to the master branch.

[oliviertassinari]

@Nef10 I don't get it, when I try your reproduction on a blank page, it works as expected.

[danilo-leal]

I was being able to reproduce it normally before opening the PR (hence doing it) — maybe something's changed with the force push to publish the Survey post?!

[oliviertassinari]

@danilo-leal Can you still reproduce? If you can't reproduce anymore.

[Nef10]

Hey, as I mentioned in the original bug report, the path had been adjusted in the docs, just not deployed yet. The deployment of v5.5.0 a couple of days ago fixed this problem.

Let me try to describe it again, to make it more understandable:

1. PR [docs] Migrate content to the new location #30757 moved some files which are linked from the help page.
2. Therefore the links obviously broke. No caching problem.
3. While the PR also change the links in the help pages, these are only deployed when a new version is released, and not on every commit (which is the correct thing to do, but caused the bug nonetheless)
4. The release of v5.5.0 deployed the help pages with updated links which is why the problem is fixed now.

How to prevent this?
If files linked from help pages are changed, immediately after merging a release should be done to update the help pages.

[oliviertassinari]

#31425 should prevent this to happen again in the future. The links from the docs to GitHub are more resilient to source changes. This will also help with docs versioning.