Versioned documentation: keep the public default on the latest stable release by Mmoncadaisla · Pull Request #246 · xqlsystems/xarray-sql

Version the docs site with mike: stable release as public default, pre-releases and dev deployed alongside.

Mmoncadaisla

committed

f245923

Point README docs links at the latest/ alias; the site root redirect only covers the root path.

Mmoncadaisla

committed

a8ad9a1

Skip Pages publish until a default docs version exists, so the pre-versioning site stays live through the migration.

Mmoncadaisla

committed

b4408c0

Serialize only the Pages publish and retry the gh-pages push: a queued workflow-level group can drop a pending release run, losing its latest-alias move.

Mmoncadaisla

committed

cce14a3

Validate release tags and dispatch versions before handing them to mike as version identifiers.

Mmoncadaisla

committed

25500e6

Pin the mike fork to a commit SHA; it is installed from a mutable branch in a job with contents: write.

Mmoncadaisla

committed

5816a38

Drop the redundant version default; the theme already falls back to the 'latest' alias.

Mmoncadaisla

committed

8106da5

Document how to roll back the docs deployment of a bad release.

Mmoncadaisla

committed

e63fdab

Deploy pre-release docs to a rolling 'rc' version: a patch-level RC must not overwrite the stable X.Y that 'latest' points to.

Mmoncadaisla

committed

56c9bb5

Take the docs source ref as a dispatch input: dispatching from an old tag uses that tag's workflow definition, which has no manual trigger.

Mmoncadaisla

committed

9fdb8f2

Never move 'latest' backward: a maintenance release for an older line must not repoint the public default.

Mmoncadaisla

committed

86715b7

Rollback docs: use the pinned mike fork for deletion and republish through the workflow, since gh-pages pushes alone never reach Pages.

Mmoncadaisla

committed

973f0a5

Evaluate the latest-alias guard against freshly fetched gh-pages on every push attempt; the resolve-time check could act on stale state when releases overlap.

Mmoncadaisla

committed

f5214c8

Newest-wins concurrency for rolling docs builds so an overlapping older build cannot overwrite dev/ or rc/ content.

Mmoncadaisla

committed

bb468c4

Allow manual redeploys of the rolling rc docs version, but never as the public default.

Mmoncadaisla

committed

8678e6a

Manual rc rebuilds join the rc concurrency group and keep their tag-derived title.

Mmoncadaisla

committed

1665abd

Queue stable-release docs builds so releases of the same line deploy in publish order.

Mmoncadaisla

committed

299702b

Tighten workflow comments.

Mmoncadaisla

committed

a320d49

Treat a tag pre-release suffix as pre-release even without the release checkbox, and inject the version provider when backfilling docs from pre-versioning tags.

Mmoncadaisla

committed

795fa4b

Fail closed when the current latest target cannot be verified; only a confirmed-absent gh-pages branch may bypass the guard.

Mmoncadaisla

committed

5b872a6

Detect pre-releases by the suffix after the patch number, not by any hyphen in the tag; build metadata may contain hyphens.

Mmoncadaisla

committed

8626b34

Reset the local gh-pages branch to the remote between push retries; a stale local branch replays the same non-fast-forward rejection.

Mmoncadaisla

committed

cf719da

Navigation Menu

Uh oh!

Versioned documentation: keep the public default on the latest stable release - #246

Versioned documentation: keep the public default on the latest stable release#246
alxmrs merged 22 commits into
xqlsystems:mainfrom
Mmoncadaisla:docs/versioned-docs

Commits on Aug 19, 2026

Version the docs site with mike: stable release as public default, pre-releases and dev deployed alongside.

Point README docs links at the latest/ alias; the site root redirect only covers the root path.

Skip Pages publish until a default docs version exists, so the pre-versioning site stays live through the migration.

Serialize only the Pages publish and retry the gh-pages push: a queued workflow-level group can drop a pending release run, losing its latest-alias move.

Validate release tags and dispatch versions before handing them to mike as version identifiers.

Pin the mike fork to a commit SHA; it is installed from a mutable branch in a job with contents: write.

Drop the redundant version default; the theme already falls back to the 'latest' alias.

Document how to roll back the docs deployment of a bad release.

Deploy pre-release docs to a rolling 'rc' version: a patch-level RC must not overwrite the stable X.Y that 'latest' points to.

Take the docs source ref as a dispatch input: dispatching from an old tag uses that tag's workflow definition, which has no manual trigger.

Never move 'latest' backward: a maintenance release for an older line must not repoint the public default.

Rollback docs: use the pinned mike fork for deletion and republish through the workflow, since gh-pages pushes alone never reach Pages.

Evaluate the latest-alias guard against freshly fetched gh-pages on every push attempt; the resolve-time check could act on stale state when releases overlap.

Newest-wins concurrency for rolling docs builds so an overlapping older build cannot overwrite dev/ or rc/ content.

Allow manual redeploys of the rolling rc docs version, but never as the public default.

Manual rc rebuilds join the rc concurrency group and keep their tag-derived title.

Queue stable-release docs builds so releases of the same line deploy in publish order.

Tighten workflow comments.

Treat a tag pre-release suffix as pre-release even without the release checkbox, and inject the version provider when backfilling docs from pre-versioning tags.

Fail closed when the current latest target cannot be verified; only a confirmed-absent gh-pages branch may bypass the guard.

Detect pre-releases by the suffix after the patch number, not by any hyphen in the tag; build metadata may contain hyphens.

Reset the local gh-pages branch to the remote between push retries; a stale local branch replays the same non-fast-forward rejection.