docs(ci): document main-health.yml, the workflow the CI page never listed #2345
No reviewers
Labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
jaylouisw/packetforge!2345
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "docs/1121-0117"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
docs/CI.mdsays it is written from the workflows in.forgejo/workflows/— "if the two disagree the workflow is right and this page is a bug".main-health.ymllanded there on 2026-11-20 (#2326) and the page never mentioned it.Three statements were untrue as a result:
wiki-sync.yml, so the job that turns a redmaininto an issue was undocumented; a reader of the page could not know it exists, what it opens, or that it writes issues at all..forgejo/workflows/holds — six files named, seven present.The new row is written from the file: a 15-minute schedule plus a manual dispatch taking
sha(default the head ofmain) anddry_run(defaulttrue); it reads the head's status set and opens one issue titledmain is red, naming every failing check with the run link its status carries, reporting a given head once (the head is written into the issue body) and commenting and closing on the first green tick. It merges, rebases and arms nothing, and a tick that cannot read the status set warns instead of reportingmainas fine.The token paragraph now separates the workflows that must push (which is why the secret exists) from
main-health.yml, which only writes issues —permissions: issues: writealready grants the automatic token, and the file falls back to it with a warning.Docs only.
node scripts/syntax-check.js509 files OK; docs-show-commands 7/7, help-completeness 8/8, help-forms 81/81, docs-cli-transcript 9/9; check-doc-citations 370 citations, 0 beyond drift; doc-catalog-counts 43.