diff --git a/docs/CONSOLE.md b/docs/CONSOLE.md index e3cf328c..bf16ab0e 100644 --- a/docs/CONSOLE.md +++ b/docs/CONSOLE.md @@ -171,7 +171,13 @@ Select a worker to open its page. It adds: - **Load**: how busy the machine is right now: CPU busy share and cores, memory available of total, swap used, memory pressure (`normal`, `warn` or `critical`, left out where the system does not report it), and disk free of - total. A part the worker could not read says `Unavailable`. **Read** says how + total. CPU, memory and disk each have a bar under the figure showing how full + it is, for scanning at a glance: the memory bar takes the colour of its + pressure, and is itself neutral where no pressure is reported. The other two + stay neutral because the worker sends no CPU or disk threshold for the console + to judge them against — a `(limit)` beside a figure is the worker's own limit + on that figure, not a level to be judged against. A part the worker could not + read says `Unavailable`, and has no bar. **Read** says how long ago the reading was taken, and it ticks up until the next one. A worker that sent no load says "Not reported.", and a disconnected one "No reading while disconnected." diff --git a/docs/internal/DESIGN.md b/docs/internal/DESIGN.md index 6f4d0e6c..9a25e544 100644 --- a/docs/internal/DESIGN.md +++ b/docs/internal/DESIGN.md @@ -179,6 +179,22 @@ scale; never a value between. nothing is visible only in the picture. A chart can be focused, and the arrow keys step through it. Its focus ring goes round the whole chart, for keyboard focus only: a click on a chart draws none. +- **Load gauges.** On a worker's page, each of the Load panel's CPU, memory and + disk figures carries a bar in a line of its own under it: 8px high, `--field` + track, `max-width: 20rem`, square, and never the accent. Its fill takes a + status colour by class; its level arrives inline: `style-src 'self'` refuses a + style attribute in markup, and the level arrives anyway because React writes + styles through the CSSOM, where the policy does not reach. ADR 0011 allows the + `style` prop because it creates no `