Skip to content

Handle docs-version-deploy dispatch and auto-update archived versions#3

Merged
leseb merged 1 commit into
mainfrom
leseb/versioned-docs-deploy
Apr 29, 2026
Merged

Handle docs-version-deploy dispatch and auto-update archived versions#3
leseb merged 1 commit into
mainfrom
leseb/versioned-docs-deploy

Conversation

@leseb
Copy link
Copy Markdown
Contributor

@leseb leseb commented Apr 29, 2026

Summary

  • Add docs-version-deploy to repository_dispatch types so the ogx repo can trigger versioned doc builds on new releases
  • Read version from client_payload.version before falling back to workflow_dispatch input
  • Add a post-build step that auto-updates versionsArchived.json with the newly built version (sorted by semver descending)
  • Replace the static versions.html with a redirect to /versions (the dynamic Docusaurus versions page)

Test plan

  • Trigger workflow manually via workflow_dispatch with version: v0.7.1 and action: build-and-deploy
  • Verify archived build is created and deployed at https://ogx-ai.github.io/v0.7.1/
  • Verify versionsArchived.json is updated with the new entry
  • Verify versions.html redirects to /versions

…json

- Add docs-version-deploy to repository_dispatch types
- Read version from client_payload before falling back to workflow_dispatch input
- Add step to update versionsArchived.json after versioned builds
- Replace static versions.html with redirect to /versions

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@leseb leseb merged commit aa9f11e into main Apr 29, 2026
1 check passed
@leseb leseb deleted the leseb/versioned-docs-deploy branch April 29, 2026 10:09
skamenan7 pushed a commit to skamenan7/llama-stack that referenced this pull request Apr 29, 2026
…ployment (ogx-ai#5652)

# What does this PR do?

Fixes the broken versions page at ogx-ai.github.io/versions.html by
replacing the static hardcoded HTML with a dynamic Docusaurus page that
fetches all releases from the GitHub API and checks
`versionsArchived.json` for which versions have hosted documentation.
Also extends the docs deploy workflow to automatically trigger versioned
doc builds when a release is published, dispatching
`docs-version-deploy` to ogx-ai.github.io.

Companion PR: ogx-ai/ogx-ai.github.io#3

## Test Plan

1. Run the Docusaurus dev server (`cd docs && npm run start`) and
navigate to `/versions` — verify all GitHub releases are listed with
dates and "Documentation" links for versions that have deployed docs.
2. Navigate to `/versions.html` — verify it redirects to `/versions`.
3. After merging both PRs, trigger `Trigger Docs Deploy` workflow
manually with `tag: v0.7.1` to verify versioned docs build and deploy to
ogx-ai.github.io/v0.7.1/.

Signed-off-by: Sébastien Han <seb@redhat.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

1 participant