Two docs paragraphs predate the home page and still describe the old model #210

New issue

Closed

opened 2026-09-19 00:59:56 +00:00 by claude-bot · 0 comments

claude-bot commented

2026-09-19 00:59:56 +00:00

Collaborator

DocumentationTests catches the mechanical half of doc staleness and cannot catch prose. Two paragraphs went stale across #193/#194 and now state the reverse of what the code does:

docs/auth.md:16 — "the Admin policy … gates /admin: the invite list (/admin/members with its requests and invites panels) and the one form that still makes a board (/admin/boards)". That form is gone. /admin/boards is served by Components/Pages/Admin/AdminRedirect.razor, which carries a bare @attribute [Authorize] — not the Admin policy — and redirects home. Making a board is a tile on the home page. As written, the paragraph tells the next reader that the super-admin policy still gates board creation.
docs/frontend.md:45 — "That row names the board explicitly rather than copying the bare path, because / means the reader's default board". There is no default board; / is the home page. The behaviour the sentence describes is still correct, but the reason it gives has been reversed by #194, and docs/boards-and-permissions.md:36 now says the opposite. The same sentence goes on to list /admin/boards as a page the share row is absent from, which is a page that no longer renders.

Both need rewriting with the current reason, not just the current fact. Found while reading for the #196 design; neither is mine to have broken and neither is in that issue's scope.

Filed by Claude while working on #196 (run).

`DocumentationTests` catches the mechanical half of doc staleness and cannot catch prose. Two paragraphs went stale across #193/#194 and now state the reverse of what the code does: - **`docs/auth.md:16`** — "the `Admin` policy … gates `/admin`: the invite list (`/admin/members` with its requests and invites panels) **and the one form that still makes a board (`/admin/boards`)**". That form is gone. `/admin/boards` is served by `Components/Pages/Admin/AdminRedirect.razor`, which carries a bare `@attribute [Authorize]` — not the `Admin` policy — and redirects home. Making a board is a tile on the home page. As written, the paragraph tells the next reader that the super-admin policy still gates board creation. - **`docs/frontend.md:45`** — "That row names the board **explicitly** rather than copying the bare path, **because `/` means *the reader's* default board**". There is no default board; `/` is the home page. The behaviour the sentence describes is still correct, but the reason it gives has been reversed by #194, and `docs/boards-and-permissions.md:36` now says the opposite. The same sentence goes on to list `/admin/boards` as a page the share row is absent from, which is a page that no longer renders. Both need rewriting with the current reason, not just the current fact. Found while reading for the #196 design; neither is mine to have broken and neither is in that issue's scope. --- _Filed by Claude while working on #196 ([run](https://git.grandiras.net/Grandiras/claude-bot/actions/runs/567))._

claude-bot referenced this issue

2026-09-19 00:59:56 +00:00

Super-admin: delete any board, ban a member (needs a design first) #196