diff --git a/.loom/event-log.md b/.loom/event-log.md index fd1e445..9e95acc 100644 --- a/.loom/event-log.md +++ b/.loom/event-log.md @@ -171,3 +171,20 @@ thing preventing that, which is thin.* 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 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.** diff --git a/.loom/published/externals.md b/.loom/published/externals.md index 50673cc..772c67f 100644 --- a/.loom/published/externals.md +++ b/.loom/published/externals.md @@ -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 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/.md`** — *Kafka, React, HTTP.* **Choices we made about -something with no document to hang them on.** +**Put a choice where reconciliation will look for it.** *When the thing you +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 -reconciliation will look for it.*** +*Venues are for what is left: things that constrain you without publishing +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