README.md: instructions refresh

README.md

@@ -107,15 +107,29 @@ Per-origin thresholds (published `thresholds.json`): `fcv_pads_east_africa`
 `ruling` is `DATA_MENTION` (keep) or `NON_MENTION` (drop) — same labels as the deck export.
 ## review.html (current)
 
-Multi-span review over `rafmacalaba/data-use-ner`: `gliner` holdout (gold 473)
-and `to_annotate` (pool + per-user `annotate_{paddy,aj,aivin,rafael}` sets,
-240 passages each, 24 shared for agreement). Typing your name auto-loads
-your file; annotating without a name is blocked.
-Keys: `←`/`→` mention · `k` keep · `d` drop · `space` skip ·
-`[`/`]` slide window · `-`/`+` window size. Rulings key by span `key`.
-
-Export flow (no logins, no tokens): annotators press **export** (or `e`),
-which downloads `rulings-<name>-<queue>.jsonl`. They send the file back;
-drop it into `human_labeling/annotations/` and run `merge.py` → majority
-verdict per key (ties → REVIEW) in `annotations/adjudicated.jsonl`.
-Public share: https://rafmacalaba-data-use-annotate.static.hf.space/
+Multi-span review over `rafmacalaba/data-use-ner`: `gliner` holdout (gold 473),
+`to_annotate` pool, per-user `annotate_{paddy,aj,aivin,rafael}[_part2]` sets
+(240 passages each, mutually exclusive, stratified by origin × probe tag).
+Assignment manifests live in `assignment_manifest.json` (verified equal to
+the Hub configs — queue files are append-only; never resampled in place).
+
+### For annotators
+
+1. Open your link (or pick your name on the landing page) — your file loads
+   automatically. Type your name if asked; it locks on first ruling.
+2. Judge each highlighted mention in its window: `→` next mention,
+   `k` keep, `d` drop, `space` skip, `[`/`]` slide the window,
+   `-`/`+` resize it. Optional freeform note per ruling.
+3. Before ruling you see only `probe: easy` or `probe: confusion`. After
+   ruling, Luna's verdict + reasoning appear, with a DISAGREE flag (also a
+   toast) when you differ.
+4. Every 10% you'll be nudged to **export** a checkpoint (`e` or the button,
+   header and footer). Send `rulings-<name>-<queue>.jsonl` to rafael/aivin.
+   To resume later, **import** the file back — you jump to the first
+   unreviewed mention.
+
+### For coordinators
+
+Drop returned files into `human_labeling/annotations/` and run `merge.py` →
+majority verdict per span `key` (ties → REVIEW) in `annotations/adjudicated.jsonl`.
+Public app: https://rafmacalaba-data-use-annotate.static.hf.space/