# annotating

**How two parties mark up each other's files without either of them having to
diff anything.**

- [The agreement](.loom/published/annotating.md) — `v0`

**Deliberately minimal.** *This is the most-depended-on thing loom publishes, so a
revision costs everyone downstream an afternoon.*

## What it casts, and the one thing it does not

**It is a casting of [sibling facets](https://git.hypertheory-labs.dev/loom/bedrock),
which leaves three choices to any convention built on it.** *This one answers:
the facet is `notes`; the source is fixed by the notes file existing; the pair is
released by rewriting the source and deleting the notes.*

> **That third answer holds only where you own the source.**

**Where you do not — an adopted document, somebody else's agreement — you cannot
rewrite it, and this agreement has no move for you.** *Use
[externals](https://git.hypertheory-labs.dev/loom/externals), which releases by
**replacement**.*

**That condition is not yet written into the agreement below.** *Its absence is
not theoretical: two agreements adopted on 2026-08-21 stayed frozen for three
weeks, because the only stated release required rewriting a document belonging to
somebody else.* **Nobody chose badly. Nobody was asked.**

## Provenance of this copy

**This is the copy adopted by `staribridge/substrate` on 2026-08-21 and
reconciled to `v0` the same day.** *It has been read many times and never
edited.*

**If loom's own copy differs, this one is wrong and should be replaced before
anybody adopts it.** *Published here to give the document an address, which it
did not have — `externals` already holds an external pointing at this path.*