a starting page, and it points at the example rather than replacing it

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>
This commit is contained in:
2026-09-07 11:27:19 -04:00
co-authored by Claude Opus 5
parent 0c61c7a42d
commit f026f3ea55
2 changed files with 72 additions and 1 deletions
+4 -1
View File
@@ -9,8 +9,11 @@
- [Recording decisions](.loom/published/recording-decisions.md) — what an entry
says, and why it is never revised
- [Publication](.loom/published/publication.md) — what `.loom/published/` means
- [Starting one of these in a repository](.loom/published/starting.md) — the one
page here that tells you what to do, because a set of primitives with no
starting point is a puzzle
**Nothing here says what to *do*.** *`loom/annotating`, `loom/cart` and
**Nothing else here says what to *do*.** *`loom/annotating`, `loom/cart` and
`loom/externals` are built on these and are where the practices live.*
**Most repositories will never read this.** *Its audience is people building