From 260dc7bb589d45f23eba988e3531e289fa3f0a74 Mon Sep 17 00:00:00 2001 From: atlas Date: Sat, 4 Jul 2026 20:57:57 +0200 Subject: [PATCH] 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. --- docs/ci.md | 18 +++--------------- 1 file changed, 3 insertions(+), 15 deletions(-) diff --git a/docs/ci.md b/docs/ci.md index 11e90780..59a173ef 100644 --- a/docs/ci.md +++ b/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