Broken api.laravel.com links on the Architecture Concepts: Facades documentation page (version stripped from URL)

[MariaMozgunova]

The Facade Class Reference table on the Facades doc page renders every api.laravel.com link with the version segment stripped, producing 404s.

Example:

• Source Markdown (facades.md):
  https://api.laravel.com/docs/{{version}}/Illuminate/Foundation/Vite.html
• Rendered on the live page:
  https://api.laravel.com/framework/docs/Illuminate/Foundation/Vite.html → 404 Not Found
• Correct working URL:
  https://api.laravel.com/docs/13.x/Illuminate/Foundation/Vite.html → loads fine

This affects every row in the Facade Class Reference table (~50 links), since they all follow the same api.laravel.com/docs/{{version}}/... pattern in the source.

Root cause (best guess)

The site's link renderer appears to rewrite /docs/{{version}}/... → /framework/docs/... for all doc links. That's correct for laravel.com's own internal docs (unversioned in the URL now), but it's incorrectly applied to api.laravel.com links too — that host's API documentation is still served under versioned paths (api.laravel.com/docs/{version}/...), not /framework/docs/....

Suggested fix

Exclude api.laravel.com links from the version-stripping transform, or rewrite them to api.laravel.com/docs/{{version}}/... with the actual version preserved instead of framework/docs/....

[HIRATRA]

I was able to reproduce the pattern you described from the generated links.

One thing I would check is the documentation site's link transformation step rather than the facades.md source itself. The source already contains the api.laravel.com/docs/{{version}}/... pattern, so changing the individual links would likely only mask the underlying issue.

It looks like the version placeholder is being stripped before the final URL is generated, while the same transformation is still being applied to the api.laravel.com host.

A possible fix could be to make the URL transformation host-aware:

• laravel.com/... → apply the normal documentation version stripping.
• api.laravel.com/docs/{version}/... → preserve the {version} segment.
• Ideally, the API URL could be generated from the current documentation version rather than relying on a generic URL rewrite.

That would also fix the other entries in the Facade Class Reference table automatically instead of patching each generated URL individually.

I haven't traced the documentation site's rendering pipeline yet, so I'd be interested to know where the /docs/{{version}}/ → /framework/docs/ transformation is currently implemented.