aboutsummaryrefslogtreecommitdiffstats
path: root/docs/MESHBAY_DESIGN.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/MESHBAY_DESIGN.md')
-rw-r--r--docs/MESHBAY_DESIGN.md20
1 files changed, 16 insertions, 4 deletions
diff --git a/docs/MESHBAY_DESIGN.md b/docs/MESHBAY_DESIGN.md
index d34351b..d24d7a9 100644
--- a/docs/MESHBAY_DESIGN.md
+++ b/docs/MESHBAY_DESIGN.md
@@ -33,10 +33,15 @@
| `MESHBAY_NODE_PROTOCOL.md` | the MNP wire format, message by message |
| `transfers-v1.md` | the transfer system's failure-mode analysis, kept because a synthesis cannot carry "every way a slot can be lost" |
| `playlists.md` | the playlist design in full — decided, not built (§9.10) |
-| ~~`USERGUIDE.md`~~ | **deprecated** — a large majority of it predates per-node identity, named roots and the sealed wire, and is wrong. Kept for provenance; its own banner lists what is false |
-| `PACKAGING-GUIDE.md`, `QUICKSTART.md`, `HTTPS.md`, `MAIL-SERVER.md`, `windows-build.md` | installation and server operations |
+| `cast-smart-tv.md` | the DLNA/UPnP device backend — designed, not built (§11.4) |
+| `WINDOWS-PORT.md` | the Windows port's audit and packaging detail (§11.2) |
+| `PACKAGING-GUIDE.md`, `HTTPS.md`, `MAIL-SERVER.md`, `windows-build.md` | installation and server operations |
| `CLAUDE.md` | project conventions and the engineering lessons that govern how changes are made |
-| `old-draft.md` | historical archive of drafts v1–v4. Nothing there is authoritative |
+
+**There is no user guide.** The one that existed described the system before
+per-node identity, named roots and the sealed wire, and was retired rather than
+repaired — a document a reader cannot tell the sound parts of is worse than none.
+Writing a new one starts here.
### 0.2 Reference labels
@@ -2597,7 +2602,11 @@ account recovery, and the Windows port through packaging.
## 16. Concordance
Code comments, tests and older documents cite sections of the documents this one
-replaces. The mapping:
+replaces. **Those documents are no longer in the tree** — they were removed on
+2026-09-11, once their content was here and this table could resolve every
+reference they left behind. `git log -- docs/` recovers any of them.
+
+Nothing needs editing to follow a reference: look the citation up here.
| Cited as | Read |
|---|---|
@@ -2643,6 +2652,9 @@ replaces. The mapping:
| `per-node-identity-v1.md` — identity keys per node | §3.2 |
| `captcha.md` — registration gate | §7.7 |
| `tmp-decisions.md` D1–D4 | §14.2 |
+| `first-review.md`, `second-review.md`, `third-review.md` — any finding | §13, which defines every label. §13.1 is the first review, §13.3 the second, §13.4 the third |
+| `USERGUIDE.md` — anything | it was wrong and is gone. §2 for the trust model, §3 for identity, §6.7 for the operator surface |
+| `QUICKSTART.md` — anything | it was stale and is gone. `PACKAGING-GUIDE.md` installs; §6.7 lists the operator commands |
| `devel-phases-next.md` structural decisions | §14.1 |
| `cast-smart-tv.md` | §11.4 |