the settled explanation moves here, where it can be read
A page explaining a private repository, published inside that private repository, is not published. loom-cli's builder measured it: settled, its README, and the page all return 404 anonymously. The publication did not happen, and publication.md says exactly what that means — if nobody can fetch it, nothing happened. The original defect was "the justification for settled is inside settled, which is private". The first fix put a page inside settled. Same repository, same problem, one layer in. The explanation of a thing does not belong inside the thing it explains when the thing is unreadable. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -19,7 +19,7 @@ and for finding out when it changes.***
|
|||||||
| **"how do I depend on somebody's document and know when it changes?"** | [externals](https://git.hypertheory-labs.dev/loom/externals) |
|
| **"how do I depend on somebody's document and know when it changes?"** | [externals](https://git.hypertheory-labs.dev/loom/externals) |
|
||||||
| **"how do we work something out before one of us changes it?"** | [cart](https://git.hypertheory-labs.dev/loom/cart) |
|
| **"how do we work something out before one of us changes it?"** | [cart](https://git.hypertheory-labs.dev/loom/cart) |
|
||||||
| **"how do I mark up your file without editing it?"** | [annotating](https://git.hypertheory-labs.dev/loom/annotating) |
|
| **"how do I mark up your file without editing it?"** | [annotating](https://git.hypertheory-labs.dev/loom/annotating) |
|
||||||
| **"why is it like this?"** | *`settled` — **private***, and every repository's own `.loom/event-log.md` |
|
| **"why is it like this?"** | *`settled` — **private**, [what it is](settled.md)* — and every repository's own `.loom/event-log.md` |
|
||||||
|
|
||||||
**And if you want an example rather than a description:**
|
**And if you want an example rather than a description:**
|
||||||
**[`jeffry/homelab-cluster`](https://git.hypertheory-labs.dev/jeffry/homelab-cluster)**
|
**[`jeffry/homelab-cluster`](https://git.hypertheory-labs.dev/jeffry/homelab-cluster)**
|
||||||
|
|||||||
+47
@@ -0,0 +1,47 @@
|
|||||||
|
# What `settled` is
|
||||||
|
|
||||||
|
**`settled` is private. This page is not, and it is here rather than there** —
|
||||||
|
*because a page explaining a private repository, published inside that private
|
||||||
|
repository, is not published.* **That was the first fix and it did not work; this
|
||||||
|
is the second.**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Why a decision about `externals` is not in `externals`
|
||||||
|
|
||||||
|
**Most of them are.** *`externals` has its own log, and how a consumer reconciles
|
||||||
|
is recorded there.*
|
||||||
|
|
||||||
|
**What lives here is the shape of the whole:** *that there is a `bedrock` at all;
|
||||||
|
which repositories exist and why; that affordances, stagings, roles and beads are
|
||||||
|
bracketed and what that defers; that a registry is a fan-out reader rather than a
|
||||||
|
service.* **None of those belong to any one repository, and putting them in one
|
||||||
|
would make that repository quietly authoritative over its siblings.**
|
||||||
|
|
||||||
|
> **An entry goes in the log of the repository whose decision it is.** *This is
|
||||||
|
> the repository for decisions that are nobody's in particular.*
|
||||||
|
|
||||||
|
## It is not a new kind
|
||||||
|
|
||||||
|
**One file: an `event-log`.** *The kind is exactly the one `bedrock` describes.*
|
||||||
|
**What is different is ownership, not shape** — *and if this ever holds something
|
||||||
|
that is not an event log, it has become a new kind and should say so here.*
|
||||||
|
|
||||||
|
## Why it is private
|
||||||
|
|
||||||
|
**A record of how a thing came to be shaped is mostly a record of being wrong in
|
||||||
|
public.** *Roughly a third of its entries correct earlier ones.* **That is the log
|
||||||
|
working**, and it is also not something to hand a stranger as an introduction.
|
||||||
|
|
||||||
|
*The consequence, stated because it is a real cost: **the justification for a
|
||||||
|
constraint may be unreadable by the person the constraint lands on.** If that
|
||||||
|
starts to bite, this page is the wrong fix and opening the log is the right one.*
|
||||||
|
|
||||||
|
## If you are stuck
|
||||||
|
|
||||||
|
**You do not want the entries. You want the one sentence you could not guess**,
|
||||||
|
which is at the top of this page.
|
||||||
|
|
||||||
|
**And the entries are not the way in.** *[`loom/.loom`](https://git.hypertheory-labs.dev/loom/.loom)
|
||||||
|
routes by question; [`bedrock`](https://git.hypertheory-labs.dev/loom/bedrock)
|
||||||
|
holds the primitives and a starting page.*
|
||||||
Reference in New Issue
Block a user