Skip to content

fix(docs): resolve main branch ref on tag-triggered CI checkouts#122

Merged
rederik76 merged 1 commit into
mainfrom
fix/docs-versioned-build-origin-main-ref
Jul 13, 2026
Merged

fix(docs): resolve main branch ref on tag-triggered CI checkouts#122
rederik76 merged 1 commit into
mainfrom
fix/docs-versioned-build-origin-main-ref

Conversation

@rederik76

Copy link
Copy Markdown
Collaborator

Summary

  • Fix versioned docs build failing on tag-triggered GitHub Pages runs when git log main exits 128 (no local main branch on detached HEAD checkouts).
  • Resolve branch-like refs via _resolve_git_ref() (mainorigin/main) for release dates, VERSION lookup, worktrees, and sitemap generation.
  • Add a unit test that reproduces the detached-HEAD / no-local-main scenario.

Test plan

  • pytest tests/test_select_versions.py::test_resolve_git_ref_uses_origin_main_when_local_main_missing -q
  • Merge to main and confirm main-docs.yml succeeds (or re-push v0.21.0 after merge to validate tag-triggered path)

Versioned docs builds failed when GitHub Pages workflow ran on a tag push
because the checkout is detached HEAD with origin/main but no local main.
@rederik76 rederik76 self-assigned this Jul 13, 2026
@rederik76
rederik76 merged commit fb6a41a into main Jul 13, 2026
5 checks passed
@rederik76
rederik76 deleted the fix/docs-versioned-build-origin-main-ref branch July 13, 2026 04:04
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