The model pages do not name the smaller models their rules imply #70

New Issue

2026-09-21T07:18:21Z

cgalo5758 commented

2026-09-21 07:18:21 +00:00

Where

docs/models/, the invariant sections of each model page.

What it says

Several invariants describe a smaller model with its own coherent set of rules without naming it as one. The product catalog page has two: what makes a product purchasable, and the shape a conferral takes. A reader meets the rules one at a time, spread through a longer page, and has to notice that they belong together.

What it should say

Name these smaller models where they appear, as their own subsections or their own pages, so a reader can hold one of them without reading the whole page. More will surface as pages are written, so the first pass is to collect the ones already visible and decide which form they take.

Migrated from status/issues.md at b7a0e15

## Where `docs/models/`, the invariant sections of each model page. ## What it says Several invariants describe a smaller model with its own coherent set of rules without naming it as one. The product catalog page has two: what makes a product purchasable, and the shape a conferral takes. A reader meets the rules one at a time, spread through a longer page, and has to notice that they belong together. ## What it should say Name these smaller models where they appear, as their own subsections or their own pages, so a reader can hold one of them without reading the whole page. More will surface as pages are written, so the first pass is to collect the ones already visible and decide which form they take. Migrated from status/issues.md at b7a0e15

cgalo5758 added the

kind

docs

area/meta labels 2026-09-21 07:18:21 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wiki-cafe/member-console#70