Skip to content

docs: Fix broken framework links in Cloud documentation - #791

Merged
developerjamiu merged 1 commit into
mainfrom
docs/fix-cloud-framework-links
Sep 8, 2026
Merged

docs: Fix broken framework links in Cloud documentation#791
developerjamiu merged 1 commit into
mainfrom
docs/fix-cloud-framework-links

Conversation

@developerjamiu

@developerjamiu developerjamiu commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Eight links from four Cloud pages pointed at framework paths that only exist in the 4.0 prerelease. Readers on the released version hit 404s while following the deploy, logging, caching, and web-hosting paths.

They were all written as absolute https://docs.serverpod.dev/... URLs. Docusaurus treats those as external and skips them, so the broken-link check never saw them. Each one now points at the equivalent page in the served version, written as a root-relative path like the rest of our cloud-to-framework links, so the build checks it from here on.

@developerjamiu developerjamiu self-assigned this Sep 8, 2026
@developerjamiu developerjamiu added the bug Something isn't working label Sep 8, 2026

@SandPod SandPod left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great! Can you apply these to all older versions of the documentation where this applies as well?

@developerjamiu

Copy link
Copy Markdown
Contributor Author

The Cloud docs are a single unversioned instance, so these four pages have no older copies to update. I checked all 19 versioned framework snapshots too, and none contains a docs.serverpod.dev link in any form.

On older-version readers: an unversioned Cloud page can't know which Serverpod version someone is on, so these links resolve to the current stable framework docs for everyone. That's the same behavior as every other cloud-to-framework link we have.

@SandPod SandPod left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 👍

@developerjamiu
developerjamiu merged commit 858b6dd into main Sep 8, 2026
7 checks passed
@developerjamiu
developerjamiu deleted the docs/fix-cloud-framework-links branch September 8, 2026 12:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants