Skip to content

ci: publish edgetx_2.11 (LTS) from the shared workflow - #20

Merged
pfeerick merged 1 commit into
edgetx_2.12from
publish-2.11
Oct 23, 2026
Merged

pfeerick merged 1 commit into
edgetx_2.12from
publish-2.11

Conversation

@pfeerick

@pfeerick pfeerick commented Oct 23, 2026 •

Copy link
Copy Markdown
Member

Summary

edgetx_2.11 is an LTS branch and still maintained, so its docs should republish on every push the way main and edgetx_2.12 do. The branch is still GitBook content, though, with no MkDocs config or tooling. And a push to it can only run workflows committed on that branch.

This PR makes publish-versioned-docs.yml reusable:

  • Adds a workflow_call trigger.
  • Resolves the version before checkout. For GitBook-era branches (edgetx_2.4–edgetx_2.11), it checks out the tooling from the latest release branch, runs tools/import_legacy_gitbook.py --ref origin/<branch>, and deploys the generated config with mike deploy --config-file. main/edgetx_2.12 build from their own mkdocs.yml as before, at the pushed commit.
  • Moves concurrency from workflow level to job level. Called runs then share the same lock, and a caller and callee can't deadlock on one group.
  • Collapses the 2.4–2.11 case entries into one pattern.

#21 adds the caller workflow on edgetx_2.11. It needs this PR merged into edgetx_2.12 first, because it references publish-versioned-docs.yml@edgetx_2.12.

Stacking

This PR's base is version-banners (#18), because both PRs touch the "Publish docs with mike" step. Once #18 is merged, GitHub will retarget this PR to edgetx_2.12.

Testing

I extracted the version-resolution script from the workflow YAML and ran it for each branch name:

  • main → dev
  • edgetx_2.12 → 2.12 latest
  • edgetx_2.11 and edgetx_2.4 → GitBook source, tooling from edgetx_2.12, config .site-legacy-generated/<v>/mkdocs.yml
  • unknown branches → fail with an error

The import + deploy path itself is the same one I ran by hand earlier to publish 2.4–2.11.

🤖 Generated with Claude Code

@pfeerick
pfeerick added this pull request to stack #22 October 23, 2026 09:07
Base automatically changed from version-banners to edgetx_2.12 October 23, 2026 09:09
edgetx_2.11 is still maintained but is GitBook content with no MkDocs
config or tooling. The publish workflow can now be called via
workflow_call; for GitBook-era branches it checks out the tooling from
the latest release branch, converts the caller's branch with
import_legacy_gitbook.py and deploys the generated config. edgetx_2.11
carries a small caller workflow, since a push there can only run
workflows committed on that branch.

Concurrency moves to job level so it also applies to called runs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@pfeerick
pfeerick merged commit 9c1dc23 into edgetx_2.12 Oct 23, 2026
1 check passed
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