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:
@@ -37,6 +37,21 @@ copy without inheriting the visibility it was published under.*
|
||||
|
||||
**The test is a fetch you did not perform.**
|
||||
|
||||
## Doing it
|
||||
|
||||
1. **Decide it is a contract and not a detail.** *This is the whole decision and
|
||||
the rest is mechanics.*
|
||||
2. **Move the file into `.loom/published/`.** *One commit, so the diff carries it.*
|
||||
3. **Say who the readers are** — *if it is not obvious from where it landed.*
|
||||
4. **Fetch it.** *From somewhere that is not your machine and not your account.*
|
||||
5. **Record the decision**, if you keep a log.
|
||||
|
||||
**Step 4 is the one that gets skipped and the only one that can fail.** *Steps 1
|
||||
to 3 are things you do; step 4 is a fact about the world that you find out.*
|
||||
|
||||
*Then say what it depends on. A published document that quietly requires a private
|
||||
one has moved the problem rather than solved it.*
|
||||
|
||||
## What is published is a document
|
||||
|
||||
**Prose, in whatever form its readers need.** *If a repository organises its
|
||||
|
||||
Reference in New Issue
Block a user