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/dumps.ts

@@ -1,5 +1,34 @@
 /**
- * The dump routes.
+ * The dump routes. `:dumpId` takes an id or a slug; a private dump exists only
+ * for its poster.
+ *
+ * - `POST /api/dumps` — signed in. Posts a link (JSON body) or a file
+ *   (multipart `file`, with `title`, `comment`, `isPrivate` and `categoryIds`).
+ * - `GET /api/dumps/by-url?url=` — optional sign-in. Answers the dumps already
+ *   pointing at the same thing as `url`, for the create form's duplicate hint.
+ * - `GET /api/dumps/:dumpId` — optional sign-in. Answers a dump.
+ * - `GET /api/dumps/:dumpId/voters?page=&limit=` — optional sign-in. Answers a
+ *   page of the users who upvoted it.
+ * - `GET /api/dumps/:dumpId/related` — optional sign-in. Answers the dumps
+ *   linked to or from it.
+ * - `GET /api/dumps/:dumpId/playlists` — optional sign-in. Answers the
+ *   playlists it appears in.
+ * - `GET /api/dumps?page=&limit=` — optional sign-in. Answers a page of the
+ *   dumps, newest first.
+ * - `PUT /api/dumps/:dumpId/file` — signed in, as its poster or with
+ *   `dump:moderate`. Replaces a file dump's upload (multipart).
+ * - `PUT /api/dumps/:dumpId` — signed in, as its poster or with
+ *   `dump:moderate`. Updates its title, comment, visibility, categories, and a
+ *   link's URL.
+ * - `PUT /api/dumps/:dumpId/thumbnail` — signed in, as its poster or with
+ *   `dump:moderate`. Replaces its custom thumbnail (multipart `file`, at most 5
+ *   MB).
+ * - `DELETE /api/dumps/:dumpId/thumbnail` — signed in, as its poster or with
+ *   `dump:moderate`. Removes its custom thumbnail.
+ * - `POST /api/dumps/:dumpId/refresh-metadata` — signed in, as its poster or
+ *   with `dump:moderate`. Fetches a link's preview again.
+ * - `DELETE /api/dumps/:dumpId` — signed in, as its poster or with
+ *   `dump:moderate`. Deletes it.
  *
  * @module
  */
@@ -44,38 +73,7 @@ import { getDumpVoters } from "../services/vote-service.ts";
 import { getRelatedDumps } from "../services/backlink-service.ts";
 import { getPlaylistsForDump } from "../services/playlist-service.ts";
 
-/**
- * The dump routes. `:dumpId` takes an id or a slug; a private dump exists only
- * for its poster:
- *
- * - `POST /api/dumps` — signed in. Posts a link (JSON body) or a file
- *   (multipart `file`, with `title`, `comment`, `isPrivate` and `categoryIds`).
- * - `GET /api/dumps/by-url?url=` — optional sign-in. Answers the dumps already
- *   pointing at the same thing as `url`, for the create form's duplicate hint.
- * - `GET /api/dumps/:dumpId` — optional sign-in. Answers a dump.
- * - `GET /api/dumps/:dumpId/voters?page=&limit=` — optional sign-in. Answers a
- *   page of the users who upvoted it.
- * - `GET /api/dumps/:dumpId/related` — optional sign-in. Answers the dumps
- *   linked to or from it.
- * - `GET /api/dumps/:dumpId/playlists` — optional sign-in. Answers the
- *   playlists it appears in.
- * - `GET /api/dumps?page=&limit=` — optional sign-in. Answers a page of the
- *   dumps, newest first.
- * - `PUT /api/dumps/:dumpId/file` — signed in, as its poster or with
- *   `dump:moderate`. Replaces a file dump's upload (multipart).
- * - `PUT /api/dumps/:dumpId` — signed in, as its poster or with
- *   `dump:moderate`. Updates its title, comment, visibility, categories, and a
- *   link's URL.
- * - `PUT /api/dumps/:dumpId/thumbnail` — signed in, as its poster or with
- *   `dump:moderate`. Replaces its custom thumbnail (multipart `file`, at most 5
- *   MB).
- * - `DELETE /api/dumps/:dumpId/thumbnail` — signed in, as its poster or with
- *   `dump:moderate`. Removes its custom thumbnail.
- * - `POST /api/dumps/:dumpId/refresh-metadata` — signed in, as its poster or
- *   with `dump:moderate`. Fetches a link's preview again.
- * - `DELETE /api/dumps/:dumpId` — signed in, as its poster or with
- *   `dump:moderate`. Deletes it.
- */
+/** The router serving the endpoints the module doc lists. */
 const router: Router = new Router({ prefix: "/api/dumps" });
 
 // Every route here takes a slug or an id; the services below them key on the