Contribute documents: Difference between revisions

Revision as of 12:46, 10 September 2026

Loading document OCR tools… (requires login and the OCR review service).

Site-wide inbox for document OCR. Upload a scan, confirm who it is and which soldier page would change, then Apply.

How it works

Log in (same as photo uploads).
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 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.
Check Soldier pages that will be edited at the top. Use Preview Apply to see planned changes without writing. Then Apply selected (requires ocr-reviewer or admin), or Discard the job.
Optional controls (raw OCR text, gallery attach, overwrite existing fields) are under Advanced.

You can also start from a soldier page → Gallery → OCR a document (that soldier is pre-selected).

Privacy

Do not upload Social Security numbers or private contact details for living people.
Staging files are not published until Apply (Gallery attach is optional; off by default for multi-person uploads).
See About the data and Contribute.

For reviewers

Administrators can grant the ocr-reviewer group. Other logged-in uploads stay in the queue until a reviewer applies or discards them.

@@ Line 6: / Line 6: @@
 == How it works ==
 # '''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 ==