Skip to content

[docs] Fix broken vldb23.pdf link - #6800

Merged
blp merged 1 commit into
mainfrom
docs-broken-link
Aug 4, 2026
Merged

[docs] Fix broken vldb23.pdf link#6800
blp merged 1 commit into
mainfrom
docs-broken-link

Conversation

@blp

@blp blp commented Aug 4, 2026

Copy link
Copy Markdown
Member

Docusaurus rewrites root-absolute links to static files into content-hashed asset paths, and trailingSlash:true then appends a trailing slash after the .pdf extension, producing a 404 (/assets/files/vldb23-.pdf/). Use the pathname: protocol, the convention already used elsewhere in these docs for raw file links, so Docusaurus leaves the URL untouched.

Found via the docs-linkcheck CI job.

Docusaurus rewrites root-absolute links to static files into
content-hashed asset paths, and trailingSlash:true then appends a
trailing slash after the .pdf extension, producing a 404
(/assets/files/vldb23-<hash>.pdf/). Use the pathname: protocol, the
convention already used elsewhere in these docs for raw file links,
so Docusaurus leaves the URL untouched.

Found via the docs-linkcheck CI job.

Signed-off-by: Ben Pfaff <blp@feldera.com>
@blp
blp requested a review from mihaibudiu August 4, 2026 14:45
@blp blp self-assigned this Aug 4, 2026
@blp blp added bug Something isn't working documentation Improvements or additions to documentation labels Aug 4, 2026
@mihaibudiu
mihaibudiu added this pull request to the merge queue Aug 4, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Aug 4, 2026

@mythical-fred mythical-fred left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

APPROVE.

Correct fix. Docusaurus with trailingSlash: true rewrites root-absolute static-file links into content-hashed asset paths and then appends a slash after the extension, so a bare /vldb23.pdf link ends up as …/vldb23-<hash>.pdf/ and 404s. The pathname: protocol tells Docusaurus to leave the URL alone, which is the convention already used elsewhere in these docs and is exactly the right escape hatch here. Two-line fix, caught by the linkcheck CI job — good hygiene.

@blp
blp added this pull request to the merge queue Aug 4, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Aug 4, 2026
@blp
blp added this pull request to the merge queue Aug 4, 2026
Merged via the queue into main with commit b472f6d Aug 4, 2026
1 check passed
@blp
blp deleted the docs-broken-link branch August 4, 2026 22:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants