Contribute documents: Difference between revisions

(10 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 ~~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 area → “OCR~~ a document ~~for~~ this ~~soldier”);~~ 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]]

@@ 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 area → “OCR a document for this soldier”); 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]]