docs: explain AM vs FM screening in README (MK-23) #39

Merged

David merged 1 commit from docs/readme-am-fm-MK-23 into main

2026-05-24 20:51:04 +02:00

David commented

2026-05-24 20:49:48 +02:00

Owner

Implements MK-23.

Summary

Adds a short explainer in the ### monkey image classify README section: one sentence on the radio-engineering origin of AM/FM, a two-row table comparing dot grid and what-varies, and one closing sentence tying each screening mode to the monkey signal that detects it.
Insertion point: directly after the existing paragraph that names halftone-scan and form-scan. No other prose changes.

Test plan

just check.
Visual check of the rendered Markdown table.
Forgejo CI on this PR.

Implements MK-23. ## Summary - Adds a short explainer in the `### monkey image classify` README section: one sentence on the radio-engineering origin of AM/FM, a two-row table comparing dot grid and what-varies, and one closing sentence tying each screening mode to the monkey signal that detects it. - Insertion point: directly after the existing paragraph that names `halftone-scan` and `form-scan`. No other prose changes. ## Test plan - [x] `just check`. - [x] Visual check of the rendered Markdown table. - [ ] Forgejo CI on this PR.

David added 1 commit

2026-05-24 20:49:48 +02:00

docs: explain AM vs FM screening in the README classify section

Check / fmt + clippy + build + tests (pull_request) Successful in 18s

Details

Create release / Create release from merged PR (pull_request) Has been skipped

Details

3696adf73d

The README's `monkey image classify` section names the `halftone-scan` and `form-scan` classes as "AM-halftone" and "FM-screened" but does not define those terms. A reader who is not from the print trade has no anchor for why monkey splits the two and which class a new fixture belongs in. The MK-18 taxonomy decision hinged on that distinction; documenting it here makes the split self-explanatory and lets future contributors (and AI agents picking up classifier work) place fixtures correctly.

Adds a short explainer immediately after the existing AM-vs-FM intro paragraph: one sentence linking the radio-engineering origin, a two-row table comparing dot grid and what-varies between the two screening modes, and a closing sentence tying each mode back to the monkey signal that detects it (`halftone_autocorr_peak` for AM, `panel_density` for FM). No other prose in the README changes.

#MK-23 State Done

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>