1 files changed, 7 insertions, 6 deletions
diff --git a/packages/meshbay-node/src/meshbay_node/ops.py b/packages/meshbay-node/src/meshbay_node/ops.py
index 2221bea..98f67c5 100644
--- a/packages/meshbay-node/src/meshbay_node/ops.py
+++ b/packages/meshbay-node/src/meshbay_node/ops.py
@@ -283,7 +283,7 @@ async def unpin_member(state: dict, user_id: str) -> dict:
 # the key, as `set_gek` does — would make every message anyone ever sent
 # permanently unreadable to everybody, which is what a plain GEK-derived
 # archive key would have done on the very first `member unpin`
-# (docs/chat-sender-keys.md F4).
+# (finding F4, docs/MESHBAY_DESIGN.md §13.6).
 
 
 async def _wrap_for_node(state: dict, key: bytes) -> dict:
@@ -1369,7 +1369,8 @@ async def set_node_settings(state: dict, settings: dict) -> dict:
             # `webrtc._stream_sem` was assigned here for months. That attribute
             # has never existed -- the pool is `ctx["_transcode_sem"]` -- so the
             # `hasattr` guard was always False and the setting only ever took
-            # effect on a restart, which draft-v6 §2.11 says it does not need.
+            # effect on a restart, which docs/MESHBAY_DESIGN.md §6.8 says it
+            # does not need.
             if webrtc is not None:
                 webrtc.set_capacity(
                     max_concurrent_streams=updated["max_concurrent_streams"])
@@ -1524,7 +1525,7 @@ async def set_tmdb_config(state: dict, token: str | None = None,
                           language: str | None = None) -> dict:
     """
     Whether the node uses a custom API token instead of the shipped default,
-    and in what language it queries TMDB (docs/mediacenter.md §5.5).
+    and in what language it queries TMDB (docs/MESHBAY_DESIGN.md §9.7).
 
     Node-wide (roster.py group_settings, group_id="") rather than per-group
     like set_enabled_apps: the token and the shared-cache
@@ -1554,8 +1555,8 @@ async def set_tmdb_config(state: dict, token: str | None = None,
 
 async def set_tmdb_enabled(state: dict, group_id: str, enabled: bool) -> dict:
     """
-    Whether TMDB lookups run for this group at all (docs/mediacenter.md
-    §5.5) — per-group, unlike set_tmdb_config above: an operator running a
+    Whether TMDB lookups run for this group at all (docs/MESHBAY_DESIGN.md
+    §9.7) — per-group, unlike set_tmdb_config above: an operator running a
     real media library alongside test/demo groups on one node wants
     outbound TMDB traffic (and API quota) spent for the one that needs it,
     not all of them just because one process serves both.
@@ -1576,7 +1577,7 @@ async def set_tmdb_enabled(state: dict, group_id: str, enabled: bool) -> dict:
 async def set_musicbrainz_enabled(state: dict, group_id: str, enabled: bool) -> dict:
     """
     Whether MusicBrainz lookups run for this group at all
-    (docs/musicbay.md §6) — per-group from the start, same reasoning as
+    (docs/MESHBAY_DESIGN.md §9.8) — per-group from the start, same reasoning as
     set_tmdb_enabled: a real media-library group and a test/demo group on
     one node need not share the decision to make outbound requests.
     """