Skip to content

docs: PLAIN.md — the system without its own vocabulary#252

Merged
drewstone merged 1 commit into
mainfrom
docs/plain-language
Jun 10, 2026
Merged

docs: PLAIN.md — the system without its own vocabulary#252
drewstone merged 1 commit into
mainfrom
docs/plain-language

Conversation

@drewstone

Copy link
Copy Markdown
Contributor

The Rube-Goldberg audit's verdict, shipped as a page: the engine is simple (six load-bearing pieces); the vocabulary is overweight (~60% homegrown names for standard concepts). PLAIN.md is the translation layer — five sentences with zero invented words, the core/fairness-rule/experiment-menu distinction, the full term-translation table (band screen = item discrimination; non-inferiority = clinical-trials statistics; reproducer = the arXiv:2606.11045 construction…), a one-paragraph mechanism-design framing for game-theorist collaborators, the measured claims stated plainly, and the honest weaknesses. Indexed in docs/README as the page to send anyone meeting the project cold.

The engine is six pieces; the homegrown vocabulary is heavier than the
machine it names. This page is the translation layer: five sentences with
zero invented words, the load-bearing core vs fairness-rules vs experiment-
menu distinction, the project-term → plain-English → standard-concept
table, a one-paragraph mechanism-design framing for outside collaborators,
the measured claims in plain language, and the honest weaknesses. Indexed
first in the reference track — the page to send anyone meeting the project
cold.

@tangletools tangletools left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Auto-approved PR — ac7a5a65

Blanket team auto-approval is enabled for this reviewer service.
The full PR reviewer audit still runs separately and will publish findings if it detects issues.

tangletools · auto-approval · reason: blanket_auto_approve · 2026-06-10T23:44:28Z

@drewstone drewstone merged commit 21ff9f4 into main Jun 10, 2026
1 check passed
@drewstone drewstone deleted the docs/plain-language branch June 10, 2026 23:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants