Contribute documents - Revision history

Admin: Distinguish soldier OCR from Training materials

2026-09-15T02:28:30Z

Distinguish soldier OCR from Training materials

← Older revision		Revision as of 02:28, 15 September 2026
Line 22:		Line 22:
	Administrators can grant the '''ocr-reviewer''' group. Other logged-in uploads stay 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).		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]]		[[Category:Ritchie Boys Wiki]]

Admin: Frame OCR as site-wide profile enrich

2026-09-13T21:06:14Z

Frame OCR as site-wide profile enrich

← Older revision		Revision as of 21:06, 13 September 2026
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 (photo or PDF). Printed text uses the local OCR engine~~; check~~ '''Handwriting / hard scan''' ~~when the page is~~ cursive or faint ~~(uses~~ the ~~site~~ LLM vision model when ~~configured)~~.		# 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.		# '''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.		# 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.

Admin: Frame OCR as site-wide profile enrich

2026-09-13T20:23:37Z

Frame OCR as site-wide profile enrich

← Older revision		Revision as of 20:23, 13 September 2026
Line 2:		Line 2:
	<div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>		<div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>

	Site-wide inbox ~~for~~ document ~~OCR~~. Upload a scan, confirm '''who''' it is and '''which soldier page''' would change, then Apply.		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 ==		== How it works ==
	# '''Log in''' (same as photo uploads).		# '''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~~.		# Upload a document (photo or PDF). Printed text uses the local OCR engine; check '''Handwriting / hard scan''' when the page is cursive or faint (uses the site LLM vision model when configured).
	# '''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.		# '''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 <code>ocr-reviewer</code> or admin), or '''Discard''' 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.
	# Optional controls (raw OCR text, gallery attach, overwrite ~~existing fields~~) are under '''Advanced'''.		# 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''' (that soldier is pre-selected).		You can also start from a soldier page → Gallery → '''OCR a document to enrich this profile''' (that soldier is pre-selected).

	== Privacy ==		== Privacy ==

Admin: Link Facebook OCR review for editors

2026-09-13T02:54:38Z

Link Facebook OCR review for editors

← Older revision		Revision as of 02:54, 13 September 2026
Line 20:		Line 20:
	== For reviewers ==		== For reviewers ==
	Administrators can grant the '''ocr-reviewer''' group. Other logged-in uploads stay 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).

	[[Category:Ritchie Boys Wiki]]		[[Category:Ritchie Boys Wiki]]

Admin: Simplify How it works for public contributors

2026-09-10T12:46:36Z

Simplify How it works for public contributors

← Older revision		Revision as of 12:46, 10 September 2026
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 ==

Admin: Document OCR review UI and docs

2026-09-10T12:42:39Z

Document OCR review UI and docs

← Older revision		Revision as of 12:42, 10 September 2026
Line 8:		Line 8:
	# Upload a document. OCR runs on the server; nothing is written yet.		# Upload a document. OCR runs on the server; nothing is written 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''' — 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.
	# Read '''Soldier pages that will be edited''' at the top~~, then~~ '''Apply selected''' (requires <code>ocr-reviewer</code> or admin). '''Discard''' drops the job.		# 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.
	# Expert options (raw OCR text, document type, gallery, overwrite) are under '''Advanced'''.		# Expert options (raw OCR text, document type, gallery, overwrite) are under '''Advanced'''.

	Profile shortcut: soldier page → Gallery → '''OCR a document''' (pre-selects that soldier).		Profile shortcut: soldier page → Gallery → '''OCR a document''' (pre-selects that soldier).

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

Admin: Same multi-person table for any roster scan

2026-09-07T03:45:57Z

Same multi-person table for any roster scan

← Older revision		Revision as of 03:45, 7 September 2026
Line 7:		Line 7:
	# '''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. OCR runs on the server; nothing is written 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.		# '''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.
	# Read '''Soldier pages that will be edited''' at the top, then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin). '''Discard''' drops the job.		# Read '''Soldier pages that will be edited''' at the top, then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin). '''Discard''' drops the job.
	# Expert options (raw OCR text, document type, gallery, overwrite) are under '''Advanced'''.		# Expert options (raw OCR text, document type, gallery, overwrite) are under '''Advanced'''.

Admin: OCR inbox how-to: table of person, page, profile change

2026-09-07T03:16:59Z

OCR inbox how-to: table of person, page, profile change

← Older revision		Revision as of 03:16, 7 September 2026
Line 2:		Line 2:
	<div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>		<div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>

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

	== 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. OCR runs on the server; nothing is written yet.
	# '''Confirm''' — ~~for one soldier~~, ~~check the proposed~~ page ~~changes; for a roster~~, ~~match each person~~ (~~search by name/ASN~~), ~~Include~~ the ~~ones to update~~.		# '''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.
	# Read '''~~What~~ will ~~change~~''', then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin). '''Discard''' drops the job.		# Read '''Soldier pages that will be edited''' at the top, then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin). '''Discard''' drops the job.
	# Expert options (raw OCR text, document type, gallery, overwrite) are under '''Advanced'''.		# Expert options (raw OCR text, document type, gallery, overwrite) are under '''Advanced'''.

Admin: Shorter OCR review how-to for redesigned UI

2026-09-05T04:13:19Z

Shorter OCR review how-to for redesigned UI

← Older revision		Revision as of 04:13, 5 September 2026
Line 2:		Line 2:
	<div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>		<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 for document OCR. Upload a scan, confirm who it is and what will change, then Apply.

	== How it works ==		== How it works ==
	# '''Log in''' (same as photo uploads).		# '''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. OCR runs on the server; nothing is written yet.
	# ~~For a~~ '''~~single~~''' ~~person: review proposed facts (ASN~~, ~~class, dates, rank, biography lines) and confirm~~ the ~~soldier~~ page ~~title.~~		# '''Confirm''' — for one soldier, check the proposed page changes; for a roster, match each person (search by name/ASN), Include the ones to update.
	~~# 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.~~		# Read '''What will change''', then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin). '''Discard''' drops the job.
	~~# '''Save draft''' keeps your choices~~. '''Discard''' drops the job. '''~~Apply~~''' ~~requires the <code>ocr-reviewer</code> group or an administrator~~.		# Expert options (raw OCR text, document type, gallery, overwrite) 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~~).		Profile shortcut: soldier page → Gallery → '''OCR a document''' (pre-selects that soldier).

	== Privacy ==		== Privacy ==
	* Do not upload Social Security numbers or private contact details for living people.		* 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 ==		== 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.

	[[Category:Ritchie Boys Wiki]]		[[Category:Ritchie Boys Wiki]]

Admin: Document multi-person OCR inbox instructions

2026-09-05T04:00:07Z

Document multi-person OCR inbox instructions

← Older revision		Revision as of 04:00, 5 September 2026
Line 2:		Line 2:
	<div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>		<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~~.		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).

	== How it works ==		== How it works ==
	# '''Log in''' (same as photo uploads).		# '''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 below. OCR runs on the server; nothing is written to a soldier page yet.
	# ~~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~~.		# For a '''single''' person: review proposed facts (ASN, class, dates, rank, biography lines) and confirm the soldier page title.
	# '''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 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.
			# '''Save draft''' keeps your choices. '''Discard''' drops the job. '''Apply''' requires the <code>ocr-reviewer</code> group or an administrator.

	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 → '''Contribute files''' → OCR a document); that path pre-selects that profile as the target (single-person mode).

	== Privacy ==		== Privacy ==