docs: document API reference docs workflow in DEVELOPER.md - #245
Merged
Conversation
Adds tags:['**'] so the API Reference Deployment workflow fires on tag pushes, not just main. Inert until a tag is pushed; per-package routing and root-redirect handling follow in subsequent PRs.
Routes each tag to a single package built at /<pkg>/<version>/, builds dev from main, and rebuilds the root README only on tag pushes so the root URL stops flapping. Drops the destructive content wipe and macOS sed dance.
Add a hand-edited version selector to the API reference docs, mirroring the genai-toolbox pattern adapted to our per-package layout. - hugo.toml: per-package [params.versions] lists, version_menu label, and custom "releases"/"latest" output formats wired into outputs.home - home.releases.releases: per-package dropdown fragment served at /<pkg>/releases.releases - home.latest.html: per-package latest redirect, hoisted to /<pkg>/latest/ - navbar-version-selector.html: override that runtime-includes the fragment via w3.includeHTML, so frozen old version pages show newly-added versions without a rebuild - head-end.html + static/js/w3.js: load the W3.JS include helper - generate-api-docs.sh: pass HUGO_PARAMS_PACKAGE and hoist the home-scoped outputs to the package root where the navbar fetches them
anubhav756
approved these changes
Jun 4, 2026
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
2 participants
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.
No description provided.