Someone in an empty repository saying "set this up" has nothing to read. The four
primitives say what things are and deliberately not what to do, which leaves a
set of primitives with no starting point — a puzzle rather than a foundation.
Two questions carry it: what can a reader not already know, which is what you
publish; and what do you need that nothing provides, which is a gap. Everything
else is conditional on having something to say, and the page says plainly that a
file carrying no delta should not exist.
It ends by pointing at jeffry/homelab-cluster and saying that if the two
disagree, the example is right. Precedent beats description, and a page about
writing documents should not be the longest document.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
jeffryandClaude Opus 5
f026f3ea55