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

docs/DESIGN.md holds the rules of attention, and every page has a measured first-view budget #10297

shipped production is serving it opened this has it
opened this

First child of P9 Calm (#10296); every pass after it follows these rules.

  • Write the five rules from #10296 into docs/DESIGN.md, each with a do-and-don't pair taken from a real forge page.
  • Add a test that renders each main page (the home page, a repository, an app, a pull, an issue, the lists, runs and settings) at 390 px and 1280 px. It counts what a reader sees on first view: words, text blocks and colours. It records a budget per page in one file.
  • The test fails when a page goes over its budget. A pass may lower a budget, but nothing may raise one without a note in the pull.
  • The README lists today's numbers as the baseline.

Try: bun test test/attention.test.ts prints each page's numbers against its budget.

commented

Parked by the crew: the check stayed red through 2 automatic tries (pull #10316 closed). Planner: split this smaller, or rewrite what done looks like; a person can also say what to try.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs