5d3d9441
docs: pin URL grammar, document addressing, and the attachment gap
The read plane specified both that /~user/space/path.md renders and that .md returns raw source, which cannot both hold for one URL. Extensions are format selectors, so a document's own address carries none. Adds the addressing rule for documents whose id is absent or duplicated, which skip-validation makes reachable on the approved branch. A duplicated id resolves to neither document: picking one silently would aim links and search results at a document nobody chose, with no visible sign. Records that cross-space id resolution cannot live in the read layer, since an archive is one space at one revision; the global hop needs the registry and therefore belongs in service/. Promotes attachments from a hypothetical to a measured gap: the git layer walks and accepts .md only, so embeds have nothing to resolve against.
bigbes <bigbes@gmail.com> — 2026-07-22 11:04:53 UTC
Commit 5d3d94414bf7dfcc83ca765822b436167914fdae —
view raw patch
Parent(s):
305bb09f
| File | Status | + | − |
|---|---|---|---|
docs/DESIGN.md
|
M | +33 | -6 |