@lotics/ui 47.15.0 → 47.15.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/reviewing.md +23 -0
- package/package.json +1 -1
package/docs/reviewing.md
CHANGED
|
@@ -396,6 +396,29 @@ A resting register is the cheapest thing to screenshot and the least likely to h
|
|
|
396
396
|
carries the tags ITS writer chose, so a heading inside a value announces as a peer of the page's
|
|
397
397
|
sections; sizing it down fixes what the screen SHOWS and nothing about what it ANNOUNCES.
|
|
398
398
|
|
|
399
|
+
### 7a. A chart's LINKING marks, against the marks they link
|
|
400
|
+
|
|
401
|
+
**Collect**, for any chart whose meaning lives in the relationship between marks rather than in
|
|
402
|
+
each mark alone — a bridge, a slope, a connected dot plot — the size of the CONNECTOR and the size
|
|
403
|
+
of the thing it connects, in the same axis.
|
|
404
|
+
|
|
405
|
+
- **A connector sized by the GAP between bars disappears as the bars get wider.** In a vertical
|
|
406
|
+
bridge the connector spans column-to-column, so a card wide enough for fat columns leaves a
|
|
407
|
+
linking mark a few pixels long: measured on one, 108px bars with an 8px gap drew 8×1px
|
|
408
|
+
connectors in the lightest grey. Every bar is placed correctly, the arithmetic is exact, and the
|
|
409
|
+
chart reads as unlinked blocks floating at unrelated heights — because the only thing saying
|
|
410
|
+
they are one running total is 7% the width of what it links, at the palette's faintest ink.
|
|
411
|
+
- **The signature is a chart that measures perfectly and cannot be read.** Bar heights
|
|
412
|
+
proportional to a common scale, a baseline present, and a reader who still asks what the
|
|
413
|
+
picture means. So this probe is worth running whenever a chart is reported as confusing and the
|
|
414
|
+
value encoding checks out.
|
|
415
|
+
- **Compare orientations before blaming the data.** The same component's other orientation may
|
|
416
|
+
give the connector the full row gap to run in — one measured 1×24px where the other gave 8×1px
|
|
417
|
+
— which is both the diagnosis and, often, the fix: give the chart the shape whose connectors
|
|
418
|
+
have room, rather than the shape that fills the wider slot.
|
|
419
|
+
|
|
420
|
+
→ [composition.md](./composition.md) §"Charts".
|
|
421
|
+
|
|
399
422
|
### 8. Data probe — count what is really there
|
|
400
423
|
- **Query the table before choosing a surface.** "Show thumbnails" is wrong for a corpus of nine
|
|
401
424
|
files and zero images. Images are identified by CONTENT (a grid), documents by NAME (a list) —
|