mikkeli
77952cb6c1
Replaces `type: default` — one value across every document, read by nothing, so it discriminated nothing. Types are now reference, guidelines, plan and report, applied to every markdown file with no exceptions for the hub. Plans carry status and updated, reports carry date. REPOS.md already noted that plans go stale and reports do not, but nothing made that visible: a plan from months ago looked identical to one written today. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013kj58Jugkic783b8ZrtTVZ
21 lines
703 B
Markdown
21 lines
703 B
Markdown
---
|
|
type: guidelines
|
|
---
|
|
# Display client guidelines
|
|
|
|
## 1. The client knows the contract, not the car
|
|
- No CAN frame IDs, no DBC knowledge, no device paths. Topic names and payload
|
|
schemas only.
|
|
- If rendering something requires new knowledge of the vehicle, that knowledge
|
|
belongs upstream in the decoder, not here.
|
|
|
|
## 2. Render whatever state exists, immediately
|
|
- Retained topics mean a client connecting mid-drive has state at once. Never
|
|
block the first paint on a full set of signals.
|
|
- Missing is a normal state and must have a visual form. It is not an error.
|
|
|
|
## 3. Design for a split screen
|
|
- The screen may be shared with another app. Do not assume full width.
|
|
|
|
## 4. To be added
|