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

The plan map is a component in docs/design/areas/map.md, and its classes leave §5d #5509

Merged opened this

Check · Review · Land · Live done — Landed and live in production.

Merged

mason/forge:mason/5495-the-plan-map-is-a-component-in-docs-desi → main 1 commit fork

  • Merged. mason/5495-the-plan-map-is-a-component-in-docs-desi was merged into main as 5e89f42.

Review

Sign in to review this change.
2 files changed +26 −20
docs/DESIGN.md −20
@@ -558,26 +558,6 @@ the same line (#4888).
558558 - `.wd`
559559 - **`style/content.ts`, apps, runs, and the crew** — run pages, their logs and checks (a pull's look is §5's **look**).
560560 - **`pages/board.ts`** — the board itself is §5's **board**; the spend tables `spend.ts` draws wear §5's `.table` and `.stack`, no class of their own
561 - **`pages/map.ts`** — the map of what waits for what:
562 - `.map-ask`
563 - `.map-breath`
564 - `.map-canvas`
565 - `.map-card`
566 - `.map-dot`
567 - `.map-edge`
568 - `.map-edge-crit`
569 - `.map-edge-done`
570 - `.map-main`
571 - `.map-meta`
572 - `.map-node`
573 - `.map-rule`
574 - `.map-svg`
575 - `.map-title`
576 - `.map-who`
577 - `.map-who-i`
578 - `.map-who-n`
579 - `.map-word`
580 - `.map-wrap`
581561 - **`studio/feed_style.ts`** — the home feed's cards and its composer (the apps rail is §5's card, row and btn; an admin's tick boxes and Archive are always shown, deliberately, with no Select toggle):
582562 - `.feed`
583563 - `.feed-head`
docs/design/areas/map.md added +26
@@ -0,0 +1,26 @@
1 # Plan map
2
3 The map of what waits for what (`/:owner/:name/map`): one SVG of the repository's open issues as cards, laid out by
4 dependency, with the edges between them and the pillars beside it. `mapPage` in `src/web/pages/map.ts` draws the page and `drawMap`
5 the SVG; `mapCss` there holds every rule below. A card's state (ready, working, blocked, waiting, parked, held, deferred, done)
6 is `data-state` on `.map-node`, not a class.
7
8 - `.map-wrap` — the page's two-column grid: the canvas, then the 272px side column; one column under 860px.
9 - `.map-main` — the canvas column; `min-width: 0` so a wide map never pushes the side column off the page.
10 - `.map-canvas` — the bordered frame the SVG sits in; `is-view`, `is-drag` and `is-cut` say whether it pans, is being dragged, or is cut off with a fade.
11 - `.map-svg` — the map's SVG itself, full width; its text uses the page font and never takes the pointer.
12 - `.map-rule` — the labelled line across the map above the issues that are "not linked" to any other.
13 - `.map-node` — one issue's card, a link to the issue; `data-state` sets its colours.
14 - `.map-card` — the card's rectangle, filled and stroked by the node's state.
15 - `.map-breath` — the soft accent ring around a card being worked on.
16 - `.map-title` — the issue's title on the card.
17 - `.map-meta` — the issue's number, in tabular figures.
18 - `.map-who` — the assignee's mark: a circle with an initial and a name.
19 - `.map-who-i` — the assignee's initial inside the circle.
20 - `.map-who-n` — the assignee's name beside it.
21 - `.map-word` — the state's word at the card's right edge.
22 - `.map-dot` — the coloured dot before the state's word.
23 - `.map-edge` — one dependency edge between two cards.
24 - `.map-edge-crit` — an edge on the critical path, in the accent.
25 - `.map-edge-done` — an edge with a closed issue at either end, faded.
26 - `.map-ask` — a pillar row's lead-time figures in the side column, inline, with the hover title saying what they measure.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs