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:
parent
7ef90996f6
commit
260dc7bb58
1 changed files with 3 additions and 15 deletions
18
docs/ci.md
18
docs/ci.md
|
|
@ -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
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue