Skip to content

[GH-2426] Add a branded documentation 404 page - #3385

Merged
jiayuasu merged 2 commits into
apache:masterfrom
AzazelSensei:gh-2426-docs-404
Sep 22, 2026
Merged

jiayuasu merged 2 commits into
apache:masterfrom
AzazelSensei:gh-2426-docs-404

Conversation

@AzazelSensei

Copy link
Copy Markdown
Contributor

Did you read the Contributor Guide?

Is this PR related to a ticket?

What changes were proposed in this PR?

Missing docs URLs currently hit Apache's default Not Found page. I replaced the Material 404 template with a short page that links home, SedonaSpark, and SedonaDB, and publish that page at the site root so the server can serve it.

How was this patch tested?

Confirmed https://sedona.apache.org/latest/this-page-does-not-exist/ still returns Apache's default 404, while /latest/404.html is only an h1. I did not run the full docs workflow locally.

Did this PR include necessary documentation updates?

  • Yes, I have updated the documentation.

Missing docs URLs currently hit Apache's default Not Found page.
Replace the Material 404 template with a short page that links home,
SedonaSpark, and SedonaDB, and publish it at the site root so the
server can serve it.
@jiayuasu

Copy link
Copy Markdown
Member

A standalone page avoids MkDocs language simply solves the problem. The 70-line restoration hook, per-version configuration, and dependency on the stable release’s generated page add complexity without helping that requirement.

Drop the MkDocs template, i18n restoration hook, and copy from latest.
Publish a static page at the site root instead.
@AzazelSensei

Copy link
Copy Markdown
Contributor Author

Dropped the MkDocs template, the restoration hook, and the copy from latest. Root 404 is a standalone page now, with ErrorDocument pointing at it.

@jiayuasu jiayuasu left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thank you!

@jiayuasu jiayuasu added this to the sedona-2.0.0 milestone Sep 22, 2026
@jiayuasu
jiayuasu merged commit 161dd9a into apache:master Sep 22, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add a better 404 page

2 participants