docs: version the shared stylesheet and top bar URLs - #181
Merged
Merged
Conversation
agentrust-io.com serves design-system.css and supernav.js with Cache-Control max-age=14400, and this site loaded both without a query string, so browsers kept an old top bar for up to four hours after the hub changed it. Both URLs now carry ?v=21, the CSS_VERSION the hub pages use, with a comment saying where that number lives. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013aK3gVWzNdcM3hZ2o2awK2
imran-siddique
requested review from
a team,
carloshvp and
zohebk8s
as code owners
September 14, 2026 22:12
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
1 participant
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.
This site loads two files from agentrust-io.com:
design-system.cssinextra_cssandsupernav.js, the shared top bar, inextra_javascript. Both URLs had no query string, and agentrust-io.com serves them withCache-Control: max-age=14400. After agentrust-io.github.io #72 cut the top bar from 14 links to 9 on 2026-09-14, a browser that had visited any AgenTrust site in the previous four hours kept showing the old bar, including AGT, until its copy expired.Both URLs now end in
?v=21, theCSS_VERSIONin agentrust-io.github.iotools/site_header.pythat every hub page already uses for the stylesheet. A comment above each line says to bump the number there and here together. A companion hub PR versionssupernav.json its own pages the same way, and extends the scheduled availability check to report any docs site whose URLs lag the hub.Checked
mkdocs.ymlstill parses, withextra_cssandextra_javascripteach holding the one versioned URL.https://agentrust-io.com/design-system.css?v=21andhttps://agentrust-io.com/supernav.js?v=21both return 200; GitHub Pages ignores the query string, so the file served is unchanged.Generated with Claude Code
https://claude.ai/code/session_013aK3gVWzNdcM3hZ2o2awK2