docs: remove unused warnOldDocs.js and projectSpecificFooter template - #3547
Merged
Merged
Conversation
Motivation: warnOldDocs.js is the Akka-era "old docs version" banner script. It is only referenced from _template/projectSpecificFooter.st, a footer hook that the pekko-theme-paradox page templates never include, so no generated page loads the script (confirmed on the published site). Even if it were loaded, it fetches //pekko.io/versions.json, which does not exist, and its URL parsing does not match the /docs/pekko/<version>/ layout. Modification: Delete docs/src/main/paradox/assets/js/warnOldDocs.js and docs/src/main/paradox/_template/projectSpecificFooter.st. Result: Dead docs assets are gone; generated docs are unchanged apart from no longer shipping the unused script. Tests: - Not run locally - docs only; CI builds the docs References: None - cleanup of unused Akka-era docs assets
raboof
approved these changes
Sep 18, 2026
raboof
left a comment
Member
There was a problem hiding this comment.
a bit sad (we're still publishing old versions of the docs, e.g. https://pekko.apache.org/docs/pekko/1.6.0/ , and it's nice to point people to the latest version), but better to clean it up (and potentially resurrect later) than to leave it broken
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
docs/src/main/paradox/assets/js/warnOldDocs.jsis the Akka-era "you are reading an old version of the docs" banner script. It is dead code:docs/src/main/paradox/_template/projectSpecificFooter.st, a footer hook from Akka's own Paradox theme. Thepekko-theme-paradoxpage.st/footer.sttemplates never includeprojectSpecificFooter, so no generated page loads the script. The published site confirms this:https://pekko.apache.org/docs/pekko/current/index.htmlonly loads the theme's scripts, though the unused.jsfile is still copied into the site as a static asset.//pekko.io/versions.json, which does not exist (pekko.iodoes not resolve;pekko.apache.org/versions.jsonis a 404), so the banner logic is a no-op.<project>/<version>/path layout and does not match/docs/pekko/<version>/.None of the other Pekko repos (pekko-http, pekko-connectors, pekko-grpc, pekko-persistence-jdbc, pekko-management) carry this file.
Modification
Delete
warnOldDocs.jsand_template/projectSpecificFooter.st(both directories are now empty and removed).Result
Unused docs assets are gone. Generated docs are unchanged apart from no longer shipping the unused script.
Tests
References
None - cleanup of unused Akka-era docs assets.