Skip to content

README: document the workflow templates and the TagBot env: marker#129

Merged
mtfishman merged 1 commit into
mainfrom
mf/document-tagbot-marker
Apr 27, 2026
Merged

README: document the workflow templates and the TagBot env: marker#129
mtfishman merged 1 commit into
mainfrom
mf/document-tagbot-marker

Conversation

@mtfishman
Copy link
Copy Markdown
Member

Summary

Add a "Workflow templates" section to the README explaining what template/.github/workflows/ is for and calling out the TagBot.yml marker env: REGISTRY_TAGBOT_ACTION: "JuliaRegistries/TagBot" so future readers don't remove it as dead code.

The marker exists because the General registry's TagBotTriggers workflow runs RegistryCI.TagBot.maybe_notify, which only treats TagBot as enabled on a package repo if the literal substring JuliaRegistries/TagBot appears in some file under .github/workflows/. After delegating to the reusable workflow at ITensorActions, the caller no longer contains that string, so the substring check fails. The unused env: variable carries the literal substring so the check passes.

A YAML comment would be simpler, but ITensorFormatter (itpkgfmt) strips comments when reformatting YAML — a consequence of writing through YAML.jl, whose writer does not preserve comments (tracked upstream at YAML.jl#245).

ITensorActions's README carries the full technical explanation; this README cross-references it and adds a short "do not remove this env: block" note.

Source is examples/README.jl (Literate.jl regenerates README.md). Bumps to v0.3.52.

Test plan

  • No code changes; documentation only.
  • Pre-commit checks pass (yaml/toml/EOL/ITensor formatter).

🤖 Generated with Claude Code

Add a "Workflow templates" section explaining what
template/.github/workflows/ contains, with a specific call-out for the
TagBot.yml marker `env: REGISTRY_TAGBOT_ACTION: "JuliaRegistries/TagBot"`:
why it's there, and why an inline YAML comment can't be used (itpkgfmt
strips YAML comments via YAML.jl's writer, see YAML.jl#245). Cross-
references ITensorActions for the full technical explanation.

Bump to v0.3.52.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@mtfishman mtfishman enabled auto-merge (squash) April 27, 2026 16:24
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 27, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.34%. Comparing base (ced1588) to head (b735305).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #129   +/-   ##
=======================================
  Coverage   87.34%   87.34%           
=======================================
  Files           1        1           
  Lines         158      158           
=======================================
  Hits          138      138           
  Misses         20       20           
Flag Coverage Δ
docs 60.13% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@mtfishman mtfishman merged commit dca0d58 into main Apr 27, 2026
17 checks passed
@mtfishman mtfishman deleted the mf/document-tagbot-marker branch April 27, 2026 19:36
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