From f059cb118c556d1f0279350507f74b8a47d5a98a Mon Sep 17 00:00:00 2001 From: Christophe Besson Date: Fri, 11 Sep 2026 00:19:06 +0200 Subject: docs: remove the documents MESHBAY_DESIGN.md replaces MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Twenty-four files, about 17 000 lines: the two architecture drafts, the three security reviews, eleven design notes, the roadmap, the decisions file, the v1–v4 archive, the deprecated user guide and the stale quickstart. Their content is in MESHBAY_DESIGN.md, and git history holds the originals. The reason to delete rather than keep bannered: a document that is superseded but present still gets read, and a reader cannot always tell which of two accounts of one mechanism is the live one. That was the argument for retiring the user guide rather than repairing it, and it applies to the whole set. What made this safe is the concordance. Roughly 290 comments and docstrings cite these files by section — `musicbay.md §6`, `mediacenter.md §5.5`, `draft-v6 §2.11` — and section 16 maps every one onto its replacement, so not a single comment needs editing to stay followable. It now says plainly that the files are gone and where to recover them, and it gained rows for the three reviews (their findings are section 13), and for the two guides. Four kept documents pointed into the set and were repointed first: `playlists.md` (nine references — it is a live proposal and must not dangle), `WINDOWS-PORT.md`, and CLAUDE.md's example. No dangling reference remains outside section 16. Two files were dropped from the list after checking what they hold. `HTTPS.md` is an operational runbook — Caddy, certificate renewal, DNS, troubleshooting — and MESHBAY_DESIGN.md deliberately covers no operations, so nothing would replace it; the versioned Caddyfile is the config, not the procedure. `cast-smart-tv.md` is the plan for the unbuilt DLNA phase of a feature whose first two phases ship, and section 11.4 summarises it in four lines rather than carrying the SSDP/UPnP work. There is no user guide now, and section 0.1 says so rather than leaving a reader to discover it. Suites green: 2258 passed, 4 skipped. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01YVoHVCcfBqud6ZjG4db3y7 --- docs/playlists.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) (limited to 'docs/playlists.md') diff --git a/docs/playlists.md b/docs/playlists.md index aef2366..8e57546 100644 --- a/docs/playlists.md +++ b/docs/playlists.md @@ -1,13 +1,14 @@ # MeshBay — Playlists (design) -> Status: **proposal**, not implemented. This is M4 in `docs/musicbay.md` §9, +> Status: **proposal**, not implemented. This was deferred out of the Music +> application's design, > which deferred it for the right reason: *"a genuinely new category of > per-account node state, not covered by anything E9 already enumerates — > needs its own design pass (ownership, sync across devices, whether it's > node-local or something else)"*. This document is that pass. > -> Read `docs/musicbay.md` first — Music is built, and this adds nothing to -> its playback path. Read `docs/refactoring-search.md` second: the +> Read `MESHBAY_DESIGN.md` §9.8 first — Music is built, and this adds nothing +> to its playback path. Read §9.11 second: the > cross-group consolidation this feature needs already exists there, and > most of the work is recognising that. > @@ -33,16 +34,16 @@ this must not corrupt anything. ## 1. What this design does not reopen -- **Views over the index, never a catalogue** (`desktop-client-v1.md` §6.10, +- **Views over the index, never a catalogue** (`MESHBAY_DESIGN.md` §6.5, §9.1, draft-v6 §2.7). A playlist is a list of *references*; it creates no second identity for a file and no server-side database of content. - **Nothing about content reaches the hub** (H7, draft-v6 §2.5). §3.1. -- **No new streaming path.** `musicbay.md` §2.2 stands untouched: a track is +- **No new streaming path.** `MESHBAY_DESIGN.md` §9.8 stands untouched: a track is fetched through `pipelinedDownload` and handed to `