molecule-ci/.github/workflows
Hongming Wang b24e11976a
docs: recommend @v1 over @main in reusable-workflow adoption snippets (#16)
Closes the README half of monorepo task #133. The v1 git tag now
exists at the current main HEAD (8b0fbac — includes the auto-promote
fail-loud fix from #15). Consumers should pin reusable-workflow refs
to @v1 so future breaking changes land on @v2 with @v1 staying
backward-compatible — same pattern as `actions/checkout@v4`.

This commit only updates the EXAMPLE adoption snippets in the
workflow headers. Existing consumers pinned at @main keep working
identically (the workflow content is unchanged); they migrate at
their own pace when next touching their CI. New consumers see @v1
as the recommended pin.

Touched:

  - auto-promote-branch.yml (also added a paragraph explaining the
    @v1 vs @main convention so future contributors don't reintroduce
    @main as the recommendation)
  - auto-promote-staging.yml (the snippet inside this file's header
    references auto-promote-branch.yml, also moved to @v1)
  - disable-auto-merge-on-push.yml
  - publish-template-image.yml

The validate-* workflows (validate-plugin.yml, validate-org-template.yml,
validate-workspace-template.yml) don't have adoption snippets in their
headers — adding canonical examples there is a separate scope and not
part of this PR.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-28 11:14:12 -07:00
..
auto-promote-branch.yml docs: recommend @v1 over @main in reusable-workflow adoption snippets (#16) 2026-04-28 11:14:12 -07:00
auto-promote-staging.yml docs: recommend @v1 over @main in reusable-workflow adoption snippets (#16) 2026-04-28 11:14:12 -07:00
disable-auto-merge-on-push.yml docs: recommend @v1 over @main in reusable-workflow adoption snippets (#16) 2026-04-28 11:14:12 -07:00
publish-template-image.yml docs: recommend @v1 over @main in reusable-workflow adoption snippets (#16) 2026-04-28 11:14:12 -07:00
validate-org-template.yml fix(CI): embed Python secrets scanner inline in workflow, drop nested checkout 2026-04-21 11:13:28 +00:00
validate-plugin.yml fix(CI): embed Python secrets scanner inline in workflow, drop nested checkout 2026-04-21 11:13:28 +00:00
validate-workspace-template.yml feat(validate-workspace-template): strict drift gate + canonical-fetch workflow 2026-04-27 14:50:55 -07:00