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:
2026-09-08 10:55:32 -04:00
co-authored by Claude Opus 5
parent 9f46b4652a
commit 101b0280c4
2 changed files with 25 additions and 5 deletions
+17
View File
@@ -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.**