Name the colour a reader sees, and fix the 17 diagrams that drew the wrong one
Every alt text that said "accent" now says what is actually on screen: curve
green, region orange, point blue or number purple for a produced type, plain
blue where the colour only marks which item is new, selection red where the
subject is what is selected, and group blue for a group box. Fifty in all, and
no alt text in the English wiki contains the word "accent" any more.
Reviewing the pictures against the words found seventeen drawing the wrong
colour. The pale-blue-interior-under-a-recoloured-outline fault, found in the
booleans, repeated in Cleanup, Filter by Area, Select by Condition and List
Length. The six Explode scenes hand back points and were drawing them in the
old highlight blue. The two selection scenes were still blue after the switch
to red. Area's measured hexagon is a region. Select Outer Edges now fills its
four cells and draws their shared edges as the regions they are. Separate by
Type carries all three type colours at once rather than one. Vector Math Cross
is the number colour, because Cross hands back a number.
Explode Polygon is a pentagon now. A four-sided box read as the Rectangle and
Square nodes. List Length numbers its boxes 1 to 5, positions rather than
indices, so the run ends on the same 5 the read-out states. The group box says
box rather than folder, in English and in all six locales. Two labels that sat
on the lines they labelled, the Radius read-out and the Through point, are
offset perpendicular to those lines.
The two Tidy layout images are regenerated from the documents they were always
built from. They were thought to have no generator; the generator takes its
output filename as an argument, so searching for the filename found nothing.
Page corrections from reviewing the node pages against the app: Math, Move,
Crossing Census and Stability Sweep were missing the editable marker their
app sockets carry, Move and Preview were missing their defaults, Preview had
no Outputs section where the absence of one is the point, and Weave called
Flip a boolean where every other page says on/off.
Seven new diagrams, a colour rule for the old ones, and 18 titles that match the app
New diagrams: the three Regular Polygon tools, Paint Region in three panes,
Point: Center of Circle, Reverse Direction, Show Region Direction.
Colour, on Blossom's call: a diagram carries the colour of what it produces.
Curves green, regions orange, direction marks take the colour of the thing
they mark, clicked points navy, calculated points hollow point-blue. Ten
draw-tool scenes lost their fill and went green; five shape-node cards had
their fill matched to their stroke and gained numbered points with a socket
legend. Select is deliberately untouched: its blue and green are the marquee
colours, not output types.
Naming: 18 page titles disagreed with the app's own command names, Compass
Circle being the oldest of them. All 18 retitled, with their breadcrumbs,
17 Menu paths, 137 link texts and 2 stale node link texts. Slugs left alone
so the app's Help buttons still resolve.
Also: the socket legend work caught two wrong labels, a socket called Point
that is really On Circle, and Major and Minor for Major Axis and Minor Axis.
Revert to Saved loses the switch-documents section, an edge case documented
in more detail than the behaviour deserved.
Bottom nav on every page, Apollonius, and the Combine menu completed
Navigation
- Every page's own Previous/Next line is now repeated at the bottom, directly
above the Related heading. Done by tools/add_bottom_nav.py, which finds that
heading BY NAME rather than by position, so the nav never lands in the middle
of a real section.
circles-arcs
- New Apollonius section with its own figure, apollonius-cases.png, built by a
new generator build_apollonius.mjs. Three worked cases: two lines and a
circle, three circles, two points and a line. One solution solid, the rest
light and dotted. Placed immediately before the Arc tool heading.
- circle-methods.png reverted: Apollonius gets a separate diagram, not a
fourth panel on the existing one.
selection
- Select Outer Edges removed. It is a node-side command and does not belong on
the modeling-view page. Added a Related link to the node page instead.
transform-tools
- Rewritten so the page only ever speaks of transforming POINTS. Locus does not
transform objects, it transforms the free root points an object is built
from, and everything standing on them re-solves and follows.
- New callout before the Transform menu heading: if root points are shared with
objects you do not want to move, run Edit > Detach first.
- Reference and handle clicks snap in all the same ways a point does.
align-distribute
- The same Detach callout added at the bottom, below the refusal paragraph.
regions-booleans
- Paint Region added to the list of ways to build a region.
menu-combine
- The Combine menu has eight commands and this page listed six. Paint Region
and Split (Bake) added, in menu order.
- Two new pages: combine-paint.md and combine-split.md. Split's page says
plainly that it is a one-shot bake, not a live boolean.
- The Previous/Next chain shifted, so combine-fill, combine-autoregion,
combine-difference and menu-transform changed their nav lines, and _Sidebar
gained both entries.
- Both icons rendered by the normal exporter from Vera's glyphs, tinted region
like the rest of the row.
Keyboard characters only: sweep all 245 English pages
Every character that cannot be typed on a US keyboard is replaced. Em dash
becomes a colon where it introduces a list bullet's description, matching how
the Italian pages already read, and a spaced hyphen everywhere else. The
Previous/Next angle quotes and the breadcrumb arrows become < and >, the menu
path triangle becomes >, arrows spell out as -> and <->, the ellipsis becomes
three periods, and the en dash and minus sign become a hyphen.
Two characters do two jobs and are split by context. The middle dot is a pipe
where it separates links and " x " where it is multiplication, as in Min + k x
Step and Radius x cos(Angle). The degree sign becomes " degrees" after a digit
and is dropped after a letter, where it was a stale reference to the Rotate
node's Angle socket, which no longer carries one.
Also: superscript two becomes 2, the square root sign becomes sqrt, the
division sign becomes /, less-than-or-equal becomes <=, and the decorative
emoji in Home, the footer, the sidebar, community and licensing are removed.
Kept: the command, shift and option key glyphs in the shortcut lines, and the
Greek letters used as math notation.
Verified: no file changed its line count, and no markdown table row changed its
cell count.
Re-render three dark diagrams, and document six sockets the app already has
The three Rectangle: Directed variants were on a dark canvas, against
DIAGRAM_STYLE_GUIDE.md section 1, and stale: they showed a socket set the app
no longer has. Re-rendered white at deviceScaleFactor 2 from the current
spec. They were the only dark diagrams in the wiki, and had been copied into
all four other help trees.
Five pages understated the node's own inputs, checked against src/nodes/*.ts:
node-angle-bisector was missing Side, node-arc was missing Major,
node-elliptical-arc was missing Long Way, node-midpoint was missing Segment,
and node-polar-warp was missing Bend Edges. All five translations had
faithfully copied the omission and are corrected in the app repo.
Docs: macOS+Windows support, and click-to-enlarge on diagram images
Node pages: add Related back-link to the matching modeling tool
The 29 node pages that have a modeling twin each gain an "In the modeling view" entry pointing to the tool that builds the same thing on the canvas — the reverse of the modeling-to-node pass. On the seven that already had a Related section (the field-consumer, transform, and boolean nodes), the back-link is inserted as the lead bullet.
Node pages: describe every input and output socket; fix circle menu order
Every node page now carries a short description on each Inputs/Outputs socket (was ~237 bare across 59 pages), so a reader knows what each port takes or produces.
Also: document the working-unit warning in Preferences (the node graph is always millimeters; a stripe appears on the node pane when the working unit is not mm). Expand Random Per-Point (index-keyed value field, field-aware inputs only, deterministic). Fuller socket prose on Polygon (list in via Collect), Divide (list out via Item at Index), Perpendicular Bisector and Tangent (segment-or-points; the Side toggle).
Reorder the circle nodes to Center Point before Center Radius in the sidebar, the Primitives list, and prev/next nav, matching the app menu.
Edit menu (12 per-command pages incl. Snap to Objects); Node Library prev/next descends into all 79 node pages; enrich menu-select
Add Intersection Points + Angle Bisector effect diagrams
Breadcrumb + section header on all pages; wallpaper-groups → intro + four lattice pages; remove Fundamental domains
Add breadcrumb nav to all content pages; split wallpaper-groups into intro + 4 lattice pages; remove Fundamental domains
Docs: node diagrams for Combine/Construct/Data/Display/Fields/Transform (47) + special renders (Math pulldown, Realize/Preview tab, Graph Mapper body)
Docs: add input-type sections to type-polymorphic nodes
Icons: switch node-doc icons from SVG to transparent PNG (reliable GitHub rendering)
Docs: node page titles match category pattern — inline 60px icon, baseline, spaced
Docs: app icons on node pages — category/node chips replace bullets, title badges
Docs: full node library — 69 per-node pages by category, Clusters section, Fillet/Chamfer as nodes