v3: the docs follow deno doc's grain — the index page was a hand-kept list of some 250 links into deno doc's output layout (./api/main.ts/index.html), policed by mod.test.ts; deno doc has no module index of its own beyond all_symbols.html, which lists every module by path with its summary. mod.ts is now a prose overview of the three parts and their layers, linking that list once, and mod.test.ts is gone. Re-exporting everything from mod.ts, as deno doc's tutorial does for a library, was tried and doesn't fit: export * drops the 18 routers (default exports) and makes 17 names ambiguous, and deno 2.9 renders export * as namespaces with the root's module doc and nested ones empty, losing every module doc. A router's page showed one line: its endpoint list sat on the default symbol, whose summary was cut at the colon introducing it; the list is now the module doc of all 18 routers, and the router's JSDoc says so. 22 summaries ended in a colon (the routers, BandcampPlayer, migration 0016, useDumpListSync, usePlaylistListSync) and read cut short wherever deno doc shows a first paragraph alone; they end in a full stop, doc-lint.ts now fails on a colon summary, and the README states the rule. No behaviour changes; 204 backend tests pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

api/routes/follows.ts

@@ -1,5 +1,20 @@
 /**
- * The follow routes.
+ * The follow routes, all for what the caller follows.
+ *
+ * - `GET /api/follows/status` — signed in. Answers the ids of the users and
+ *   playlists they follow.
+ * - `GET /api/follows/feed/users?page=&limit=&category=` — signed in. Answers a
+ *   page of the public dumps of the users they follow, newest first, optionally
+ *   in one category.
+ * - `GET /api/follows/feed/playlists?page=&limit=&category=` — signed in.
+ *   Answers a page of the public dumps in the public playlists they follow,
+ *   most recently added first, optionally in one category.
+ * - `POST /api/follows/users/:userId` — signed in. Follows a user.
+ * - `DELETE /api/follows/users/:userId` — signed in. Stops following a user.
+ * - `POST /api/follows/playlists/:playlistId` — signed in. Follows a public
+ *   playlist.
+ * - `DELETE /api/follows/playlists/:playlistId` — signed in. Stops following a
+ *   playlist.
  *
  * @module
  */
@@ -38,24 +53,7 @@ function resolveCategoryFilter(
 /** The feed a filter naming no category yields. */
 const EMPTY_FEED: Page<Dump> = { items: [], hasMore: false };
 
-/**
- * The follow routes, all for what the caller follows:
- *
- * - `GET /api/follows/status` — signed in. Answers the ids of the users and
- *   playlists they follow.
- * - `GET /api/follows/feed/users?page=&limit=&category=` — signed in. Answers a
- *   page of the public dumps of the users they follow, newest first, optionally
- *   in one category.
- * - `GET /api/follows/feed/playlists?page=&limit=&category=` — signed in.
- *   Answers a page of the public dumps in the public playlists they follow,
- *   most recently added first, optionally in one category.
- * - `POST /api/follows/users/:userId` — signed in. Follows a user.
- * - `DELETE /api/follows/users/:userId` — signed in. Stops following a user.
- * - `POST /api/follows/playlists/:playlistId` — signed in. Follows a public
- *   playlist.
- * - `DELETE /api/follows/playlists/:playlistId` — signed in. Stops following a
- *   playlist.
- */
+/** The router serving the endpoints the module doc lists. */
 const router: Router = new Router({ prefix: "/api/follows" });
 
 // Static routes first to prevent Oak matching "status"/"feed" as a :param