Contribute documents: Difference between revisions

(8 intermediate revisions by the same user not shown)

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 proposed facts, then ~~apply only what you confirm — to one soldier or to many from the same document (team rosters, transfer orders, and similar lists)~~.

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.

~~# For a~~ '''~~single~~''' ~~person: review proposed facts (ASN, class, dates, rank, biography lines)~~ and ~~confirm~~ the ~~soldier page title~~.

# '''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 a~~ '''~~multi-person~~''' ~~roster: review~~ is ~~grouped by person~~. ~~Match each name (ASN when possible), use~~ '''~~Select all matched~~''' / '''~~Deselect unresolved~~'''~~, then~~ '''~~Apply selected to all matched~~''' ~~so team~~ membership ~~(and any other checked fields~~) ~~update every matched profile in one pass~~. ~~Gallery attach is off by default for multi-person uploads~~.

# 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.

# '''~~Save draft~~''' ~~keeps your choices~~. '''~~Discard~~''' ~~drops the job~~. '''Apply''' requires ~~the~~ <code>ocr-reviewer</code> ~~group~~ or ~~an administrator~~.

# 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 (single-person mode~~).

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]]

@@ 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 proposed facts, then apply only what you confirm — to one soldier or to many from the same document (team rosters, transfer orders, and similar lists).
+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.
-# For a '''single''' person: review proposed facts (ASN, class, dates, rank, biography lines) and confirm the soldier page title.
+# '''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 a '''multi-person''' roster: review is grouped by person. Match each name (ASN when possible), use '''Select all matched''' / '''Deselect unresolved''', then '''Apply selected to all matched''' so team membership (and any other checked fields) update every matched profile in one pass. Gallery attach is off by default for multi-person uploads.
+# 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.
-# '''Save draft''' keeps your choices. '''Discard''' drops the job. '''Apply''' requires the <code>ocr-reviewer</code> group or an administrator.
+# 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 (single-person mode).
+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]]