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`:
+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
-```yaml
+required — a lint failure blocks merge. `hive-forge ci-rerun --pr N` dispatches
-name: CI
+a `workflow_dispatch` retrigger without an empty commit.
 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.
 ## 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