publication says how; starting.md points at an example you can fetch

publication.md gains the procedure, with "fetch it, from somewhere that is not
your machine and not your account" as its own step. Steps 1-3 are things you do;
step 4 is a fact about the world you find out, which is why it is the one that
gets skipped. Declined a separate procedural document: publishing.md beside
publication.md is two files one letter apart, and the gap filed was that this
document was underspecified.

starting.md still described the worked example as private and refused to link it.
It went public four days ago. The first page a newcomer reads was demonstrating
its own lesson instead of teaching it.

Entries 82-83.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-08 08:58:17 -04:00
co-authored by Claude Opus 5
parent 6dcc06ab1c
commit ffa56daa41
3 changed files with 60 additions and 6 deletions
+36
View File
@@ -3676,3 +3676,39 @@ turns conversion from lossy-in-the-tree into lossy-absolutely.**
by the document: *the gap file is the only mechanism here where somebody who
cannot edit your document can still put a defect in front of you, and it caught
what review by the author did not.*
---
## 82 — publication says how, not only what
**Decided.** `publication.md` gains a five-step procedure, with **fetch it, from
somewhere that is not your machine and not your account** as step 4, and the note
that steps 1 to 3 are things you do while step 4 is a fact about the world you
find out.
**Advances:** the reachability property becomes something a reader can perform
rather than agree with.
**Declined:** a separate procedural document. *`publishing.md` beside
`publication.md` is two files one letter apart about the same subject, and the
gap filed against this document was that it was underspecified — which is an
argument for filling it in, not for splitting it.* **Say it once, where it is
owned.**
**The belief that could turn out false:** that a numbered list gets followed where
a stated property did not. *No evidence either way; the property was stated
yesterday and the three failures predate it.*
## 83 — starting.md points at a public worked example
**Decided.** The closing section of `starting.md` now links
`jeffry/homelab-cluster` instead of describing an example the reader cannot fetch.
**Why it was wrong:** *the example went public four days ago and the page still
said it was private.* **The first document a newcomer reads was teaching the
lesson by being an instance of it**, which is not the same as teaching it.
*The lesson is kept, because it was expensive, and now it is the reason the link
exists rather than the reason there is none.* **And the section says the thing the
split actually taught:** *the documents got better for being written to a stranger,
which was not why we did it.*