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

@@ -1,5 +1,26 @@
 /**
- * The playlist routes.
+ * The playlist routes. `:playlistId` takes an id or a slug.
+ *
+ * - `GET /api/playlists/by-dump/:dumpId/memberships` — signed in. Answers each
+ *   of the caller's playlists and whether it holds the dump.
+ * - `POST /api/playlists` — signed in. Creates a playlist.
+ * - `GET /api/playlists/:playlistId` — optional sign-in. Answers a playlist
+ *   with the dumps the caller may see in it; a private one only to its owner.
+ * - `PUT /api/playlists/:playlistId` — signed in, as its owner or with
+ *   `playlist:moderate`. Updates its title, description and visibility.
+ * - `DELETE /api/playlists/:playlistId` — signed in, as its owner or with
+ *   `playlist:moderate`. Deletes it.
+ * - `POST /api/playlists/:playlistId/dumps/:dumpId` — signed in, as its owner
+ *   or with `playlist:moderate`. Adds a dump at the top.
+ * - `DELETE /api/playlists/:playlistId/dumps/:dumpId` — signed in, as its owner
+ *   or with `playlist:moderate`. Removes a dump.
+ * - `POST /api/playlists/:playlistId/image` — signed in, as its owner or with
+ *   `playlist:moderate`. Replaces its cover (multipart `file`, at most 5 MB).
+ * - `GET /api/playlists/:playlistId/image?token=` — public; a private
+ *   playlist's cover needs its owner's media `token`. Serves its cover; 404
+ *   without one.
+ * - `PUT /api/playlists/:playlistId/order` — signed in, as its owner or with
+ *   `playlist:moderate`. Reorders the dumps the caller can see in it.
  *
  * @module
  */
@@ -39,30 +60,7 @@ import {
   validateImageUpload,
 } from "../lib/upload.ts";
 
-/**
- * The playlist routes. `:playlistId` takes an id or a slug:
- *
- * - `GET /api/playlists/by-dump/:dumpId/memberships` — signed in. Answers each
- *   of the caller's playlists and whether it holds the dump.
- * - `POST /api/playlists` — signed in. Creates a playlist.
- * - `GET /api/playlists/:playlistId` — optional sign-in. Answers a playlist
- *   with the dumps the caller may see in it; a private one only to its owner.
- * - `PUT /api/playlists/:playlistId` — signed in, as its owner or with
- *   `playlist:moderate`. Updates its title, description and visibility.
- * - `DELETE /api/playlists/:playlistId` — signed in, as its owner or with
- *   `playlist:moderate`. Deletes it.
- * - `POST /api/playlists/:playlistId/dumps/:dumpId` — signed in, as its owner
- *   or with `playlist:moderate`. Adds a dump at the top.
- * - `DELETE /api/playlists/:playlistId/dumps/:dumpId` — signed in, as its owner
- *   or with `playlist:moderate`. Removes a dump.
- * - `POST /api/playlists/:playlistId/image` — signed in, as its owner or with
- *   `playlist:moderate`. Replaces its cover (multipart `file`, at most 5 MB).
- * - `GET /api/playlists/:playlistId/image?token=` — public; a private
- *   playlist's cover needs its owner's media `token`. Serves its cover; 404
- *   without one.
- * - `PUT /api/playlists/:playlistId/order` — signed in, as its owner or with
- *   `playlist:moderate`. Reorders the dumps the caller can see in it.
- */
+/** The router serving the endpoints the module doc lists. */
 const router: Router<AuthState> = new Router<AuthState>({
   prefix: "/api/playlists",
 });