docs(ci): lint jobs are required and block merge

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.
2026-07-08 23:43:29 +02:00 · 2026-07-08 23:43:29 +02:00 · 2026-07-08 23:43:29 +02:00 · 2026-07-08 23:43:29 +02:00
1 changed files with 4 additions and 18 deletions
--- a/docs/ci.md
+++ b/docs/ci.md
@ -110,24 +110,10 @@ to avoid provisioning collisions.

 ## CI workflow

-The single CI job is defined in `.forgejo/workflows/ci.yml`:
-
-```yaml
-name: CI
-on:
-  pull_request:
-    branches: ["**"]
-jobs:
-  check:
-    name: nix flake check
-    runs-on: [hive-ci]
-    steps:
-      - uses: actions/checkout@v3
-      - name: check
-        run: nix flake check
-```
-
-This runs on every PR, executing all flake checks (treefmt, rustfmt, cargo test, cargo clippy, module evaluation). No `--no-build`: the checks' derivations are the canonical source of truth.
+Three jobs are defined in [`.forgejo/workflows/ci.yml`](../.forgejo/workflows/ci.yml):
+`nix flake check`, `tracker-tag lint`, and `comment-block lint`. All three are
+required — a lint failure blocks merge. `hive-forge ci-rerun --pr N` dispatches
+a `workflow_dispatch` retrigger without an empty commit.

 ## Security: unsandboxed builds and trusted contributors
Author	SHA1	Message	Date
atlas	9c3884e031	docs(ci): lint jobs are required and block merge	2026-07-08 23:43:29 +02:00
atlas	260dc7bb58	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.	2026-07-08 23:43:29 +02:00
atlas	7ef90996f6	docs(ci): replace YAML copy with link to .forgejo/workflows/ci.yml Per mara's feedback: don't copy the YAML inline, just reference the file.	2026-07-08 23:43:29 +02:00
atlas	bfba148f76	docs(ci): update CI workflow section to reflect 3-job layout	2026-07-08 23:43:29 +02:00