venues moved to bedrock; keep only the sentence about externals
bedrock publishes venues.md now, so the four-line section here had become the second saying of a rule owned elsewhere. Kept the one sentence that is genuinely this document's: put a choice where reconciliation will look for it, because a .usages.md is what somebody opens when a document moves. The old heading — "venues, for things you cannot fetch" — was wrong and had been since it was written. A venue is not defined by being unfetchable, it is defined by your having decided something. Kafka's documentation is extremely fetchable. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -171,3 +171,20 @@ thing preventing that, which is thin.*
|
|||||||
day.* **Documenting a format that does not exist yet is the same mistake as
|
day.* **Documenting a format that does not exist yet is the same mistake as
|
||||||
publishing into a repository nobody can read** — *it passes every check available
|
publishing into a repository nobody can read** — *it passes every check available
|
||||||
to the writer.*
|
to the writer.*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Declined: keeping the venue section
|
||||||
|
|
||||||
|
**`bedrock` publishes `venues.md` now**, *so this document's four-line section had
|
||||||
|
become the second saying of a rule owned elsewhere.*
|
||||||
|
|
||||||
|
**Kept: the one sentence that is genuinely about externals** — *put a choice where
|
||||||
|
reconciliation will look for it.* **That is a claim about `.usages.md`**, *which is
|
||||||
|
this document's, and it happens to be the sentence that tells you when **not** to
|
||||||
|
write a venue file.*
|
||||||
|
|
||||||
|
*Everything else went, including the "things you cannot fetch" framing.* **That
|
||||||
|
heading was wrong and had been since it was written:** *a venue is not defined by
|
||||||
|
being unfetchable — it is defined by your having decided something.* **Kafka's
|
||||||
|
documentation is extremely fetchable.**
|
||||||
|
|||||||
@@ -147,13 +147,16 @@ do; a closed gap is what you needed and got.*
|
|||||||
**The new copy replaces the old pair wholesale.** *There is no merging a document
|
**The new copy replaces the old pair wholesale.** *There is no merging a document
|
||||||
you do not own.*
|
you do not own.*
|
||||||
|
|
||||||
## Venues, for things you cannot fetch
|
## A choice about something you adopted does not go in a venue file
|
||||||
|
|
||||||
**`.loom/venues/<name>.md`** — *Kafka, React, HTTP.* **Choices we made about
|
**Put a choice where reconciliation will look for it.** *When the thing you
|
||||||
something with no document to hang them on.**
|
decided about publishes a document you hold a copy of, the choice belongs in the
|
||||||
|
`.usages.md` beside that copy* — **because that is the file somebody opens when
|
||||||
|
the document moves.**
|
||||||
|
|
||||||
*If there is a document, hang it there instead: **put a choice where
|
*Venues are for what is left: things that constrain you without publishing
|
||||||
reconciliation will look for it.***
|
anything you could adopt.* **See
|
||||||
|
[venues](https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/venues.md).**
|
||||||
|
|
||||||
## Gaps that belong to nobody
|
## Gaps that belong to nobody
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user