Contribute documents: Difference between revisions

Latest revision as of 02:28, 15 September 2026

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

Site-wide inbox to enrich soldier profiles from document scans — forms, certificates, clippings, letters, and team rosters. Upload a scan, confirm who it is and which soldier page would change, review proposed infobox facts and a short biography draft, then Apply.

How it works[edit | edit source]

Log in (same as photo uploads).
Upload a document (photo or PDF). Printed text uses the free local OCR engine. Check Handwriting / hard scan for cursive or faint pages — the service still runs a free print OCR first and only calls the paid LLM vision model when that preliminary read looks weak.
Confirm who the document is about. Review proposes infobox fields and a biography draft woven from clear facts — not a raw OCR dump. Nothing is written until Apply.
For multi-person IPW / team rosters, you get a table: each person, the matched wiki page, and what would be written (usually Team membership). Names, ranks, and ASNs are matching cues 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, document type, gallery attach, overwrite, handwriting re-OCR) are under Advanced.

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

Privacy[edit | edit source]

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[edit | edit source]

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

See also Facebook OCR review (editors-only queue of Facebook-sourced document OCR candidates; review aid only — prefer this page for new uploads). Camp-wide training manuals belong on Training materials, not here.

@@ Line 2: / Line 2: @@
 <div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>
-This page is the '''site-wide inbox''' for document OCR: upload a scan (image or PDF), review the extracted text and proposed facts, then apply only what you confirm to one or more soldier profiles.
+Site-wide inbox to '''enrich soldier profiles from document scans''' — forms, certificates, clippings, letters, and team rosters. Upload a scan, confirm '''who''' it is and '''which soldier page''' would change, review proposed infobox facts and a short biography draft, then Apply.
 == How it works ==
 # '''Log in''' (same as photo uploads).
-# Upload a document below. OCR runs on the server; nothing is written to a soldier page yet.
+# Upload a document (photo or PDF). Printed text uses the free local OCR engine. Check '''Handwriting / hard scan''' for cursive or faint pages — the service still runs a free print OCR first and only calls the paid LLM vision model when that preliminary read looks weak.
-# Review the OCR text and each proposed fact (ASN, class, dates, rank, biography lines). Assign a soldier page title when the upload is not from a profile.
+# '''Confirm''' who the document is about. Review proposes '''infobox''' fields and a '''biography draft''' woven from clear facts — not a raw OCR dump. Nothing is written until Apply.
-# '''Save draft''' keeps your choices. '''Discard''' drops the job. '''Apply selected''' writes only checked facts (requires the <code>ocr-reviewer</code> group or an administrator).
+# For '''multi-person IPW / team rosters''', you get a table: each person, the matched wiki page, and what would be written (usually Team membership). Names, ranks, and ASNs are matching cues 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 <code>ocr-reviewer</code> or admin), or '''Discard''' the job.
+# Optional controls (raw OCR text, document type, gallery attach, overwrite, handwriting re-OCR) are under '''Advanced'''.
-You can also start from a '''soldier page''' (Gallery → '''Contribute files''' → OCR a document); that path pre-selects that profile as the target.
+You can also start from a soldier page → Gallery → '''OCR a document to enrich this profile''' (that soldier is pre-selected).
 == Privacy ==
 * Do not upload Social Security numbers or private contact details for living people.
-* Staging files are kept for review and are not published until Apply (when the file may be added to the soldier Gallery).
+* 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 general editing and source guidance.
+* See [[About the data]] and [[Contribute]].
 == For reviewers ==
-Administrators can grant the '''ocr-reviewer''' group so trusted editors can Apply. Uploads from other logged-in users remain in the queue until a reviewer applies or discards them.
+Administrators can grant the '''ocr-reviewer''' group. Other logged-in uploads stay in the queue until a reviewer applies or discards them.
+See also [[Facebook OCR review]] (editors-only queue of Facebook-sourced document OCR candidates; review aid only — prefer this page for new uploads). Camp-wide training manuals belong on [[Training materials]], not here.
 [[Category:Ritchie Boys Wiki]]