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
|
## CI workflow
|
||||||
|
|
||||||
Three jobs are defined in [`.forgejo/workflows/ci.yml`](../.forgejo/workflows/ci.yml):
|
Three jobs are defined in [`.forgejo/workflows/ci.yml`](../.forgejo/workflows/ci.yml):
|
||||||
|
`nix flake check` (required), `tracker-tag lint`, and `comment-block lint`. The
|
||||||
- **`nix flake check`** — all flake checks: formatting (treefmt+rustfmt),
|
lint jobs are non-blocking while the legacy backlog clears. `hive-forge ci-rerun
|
||||||
cargo test, cargo clippy, module evaluation, `hivectl-docs` freshness.
|
--pr N` dispatches a `workflow_dispatch` retrigger without an empty commit.
|
||||||
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.
|
|
||||||
|
|
||||||
## Security: unsandboxed builds and trusted contributors
|
## Security: unsandboxed builds and trusted contributors
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue