Document OCR review UI and docs
Simplify How it works for public contributors
Line 6: Line 6:
== How it works ==
== How it works ==
# '''Log in''' (same as photo uploads).
# '''Log in''' (same as photo uploads).
# Upload a document. OCR runs on the server; nothing is written yet.
# Upload a document (photo or PDF of a record, form, list, or similar). OCR runs on the server; nothing is written to a soldier page yet.
# '''Confirm''' — a roster becomes a table: person on the scan, matched wiki page, and the one change that would be written on that profile (usually Team). Rank, role, and ASN from the scan are matching cues, not automatic edits. This is the same review for SO 103, 125, 135, and other multi-person scans — not a separate layout per form.
# '''Confirm''' who the document is about. If several people appear on one scan, you get a table: each person, the matched wiki page (when found), and what would be written on that profile. Names, ranks, and service numbers from the scan are matching cues — they are not applied until you approve.
# Read '''Soldier pages that will be edited''' at the top. Use '''Preview Apply''' to see planned page changes without writing. Then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin). '''Discard''' drops the job.
# Check '''Soldier pages that will be edited''' at the top. Use '''Preview Apply''' to see planned changes without writing. Then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin), or '''Discard''' the job.
# Expert options (raw OCR text, document type, gallery, overwrite) are under '''Advanced'''.
# Optional controls (raw OCR text, gallery attach, overwrite existing fields) are under '''Advanced'''.


Profile shortcut: soldier page → Gallery → '''OCR a document''' (pre-selects that soldier).
You can also start from a soldier page → Gallery → '''OCR a document''' (that soldier is pre-selected).
 
Facebook gallery OCR candidates in the 70–79% band can be seeded into this queue (review only — nothing is auto-applied). See [[Facebook OCR review]] and <code>python scripts/seed_fb_ocr_review_jobs.py</code>.


== Privacy ==
== Privacy ==