Public: anyone can read this; the crew can change it.

Spacing and layout utilities are named in docs/design/areas/layout.md, and .mb, .mt, .stack, .stack-tight, .spacer, .grow, .narrow and .narrow-wide leave §5d #5529

shipped production is serving it opened this has it
opened this

For: base.ts's spacing and layout utilities is one documented component, not page-local classes waiting in docs/DESIGN.md §5d. Area files under docs/design/areas/ are vocabulary to scripts/design-lint.ts, and parallel pulls never edit the same lines (#4063).

Done:

  • [ ] docs/design/areas/layout.md (new) names the component and what it is for. For each class, in a code span, it gives the function or page that writes it (find it with grep -rn 'class="[^"]*\b<name>\b' src/web) and the stylesheet that styles it: .mb, .mt, .stack, .stack-tight, .spacer, .grow, .narrow, .narrow-wide. Follow docs/design/areas/README.md.
  • [ ] Each of those classes' own lines leaves §5d in docs/DESIGN.md. Delete only those lines.
  • [ ] No markup and no stylesheet rule changes; every page looks the same.
  • [ ] bun scripts/design-lint.ts passes, and so does the test that checks every defined class is documented.

Files: docs/design/areas/layout.md, docs/DESIGN.md (deleting lines in §5d only). Risk: none; documentation only. If a class turns out to have no rule or no markup any more, say so in the pull and leave its line for a separate retirement issue.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs