server/scripts/swaggerFragment.js

@@ -76,6 +76,15 @@ const SLOT_MOUNT = {
   'admin.users.detail': '/api/v1/admin/users/:id',
 }
 
+// A router mounted INSIDE a registered one with `use()` needs nothing here, and
+// that was worth finding out: swagger-autogen reads a FILE and follows its
+// `require`s, so `/rust/permissions` is generated with the right prefix from
+// `rust.router.js` alone. It is the opposite of the hole phase 6 found with the
+// slot — the registration walk cannot see a nested router, and the generator can.
+//
+// A nested router exists at all because a mount prefix is ONE path segment
+// (core's `PREFIX` is `/^\/[a-z0-9][a-z0-9-]*$/`), so `/rust/permissions` cannot
+// be declared in `module.json` and has to be a `use()` under `/rust`.
 
 /**
  * Run `register()` with a recording api and return `[{ file, prefix, what }]`.