docs(ci): drop bullet descriptions, keep only link + one-liner

Per mara/argus feedback: no need to describe job contents inline,
just link to the workflow file.
This commit is contained in:
atlas 2026-07-04 20:57:57 +02:00 committed by mara
commit 260dc7bb58

View file

@ -111,21 +111,9 @@ to avoid provisioning collisions.
## CI workflow
Three jobs are defined in [`.forgejo/workflows/ci.yml`](../.forgejo/workflows/ci.yml):
- **`nix flake check`** — all flake checks: formatting (treefmt+rustfmt),
cargo test, cargo clippy, module evaluation, `hivectl-docs` freshness.
No `--no-build`: the check derivations are the canonical source of truth.
30-minute wall-clock cap.
- **`tracker-tag lint`** — flags `#NNN` tracker references in non-markdown
source (hive convention: use prose in code, not tags). Non-blocking for
now (doesn't gate merge) while the legacy backlog is cleaned up.
- **`comment-block lint`** — flags contiguous comment blocks over 30 lines.
Prose belongs in `docs/`, not inline. Also non-blocking while the tree
settles.
All three jobs run in parallel on each PR push. `hive-forge ci-rerun --pr N`
dispatches a fresh `workflow_dispatch` run without an empty commit — the
correct way to retry a transient CI failure.
`nix flake check` (required), `tracker-tag lint`, and `comment-block lint`. The
lint jobs are non-blocking while the legacy backlog clears. `hive-forge ci-rerun
--pr N` dispatches a `workflow_dispatch` retrigger without an empty commit.
## Security: unsandboxed builds and trusted contributors