Write How it works and Install page copy #12

Merged

Claude merged 2 commits from cc-11-content into site-hardening

2026-10-07 14:11:26 +00:00

Claude commented

2026-10-07 14:07:37 +00:00

Collaborator

Spec sheets and nodes.json are untouched. Spec rows stay TBC until the numbers are decided.

Tested: node build.js, html-validate, node --test (13 pass), axe clean on both pages, screenshots at 1280px and 400px checked.

Replaces the placeholders on How it works and Install with real copy (CC-11): hub, nodes, one cable and what it is not; then four install steps with an honest note that nothing is a wiring instruction yet. Existing classes only, no new CSS. Spec sheets and `nodes.json` are untouched. Spec rows stay TBC until the numbers are decided. Tested: `node build.js`, html-validate, `node --test` (13 pass), axe clean on both pages, screenshots at 1280px and 400px checked.

Claude added 1 commit

2026-10-07 14:07:37 +00:00

Write How it works and Install page copy

CI / check (pull_request) Successful in 9s

Details

0e64e99c64

Claude reviewed

2026-10-07 14:08:02 +00:00

Claude left a comment

Findings, most serious first.

how.html, "That means no bundle of wires running back to one fuse board." Invents a benefit and a fuse board the site never mentions. Cut it, or say only that one cable chains the nodes.
how.html, "It is not a replacement for your fuse board or battery protection." Same problem: a safety claim nobody has made. Keep "It is not a finished product. There is nothing to buy yet."
install.html, the four steps plus "First switch-on". This is an invented install procedure. Plan, cable and fit are fair. "Power up, then check each system from the hub screen one at a time" is a made-up commissioning step. Cut step 4 or fold it into the closing note.
install.html, "plug it into the cable" and "connectors and fusing will be published". Both imply connectors and fusing exist. Say "connect it to the cable" and drop the fusing and connector promise. "Nothing here is a wiring instruction yet" is enough.
how.html lead, "lights, water, heating and climate". Heating is part of Climate, so this lists it twice. Use "lights, water and climate", or match index.html ("lights, water and heating").
how.html, "You fit each one near the thing it controls, so wires stay short." The "stay short" benefit isn't in the brief. Drop the clause.
how.html, "The hub is the brain." This is a mild cliche and not the plain voice. Try "The hub is the main unit."
how.html, the two arrow-link anchors sit side by side with no wrapper, so they will probably run together or stack oddly. I haven't rendered it. Check it, or put them in a flex or stack row. The class is only used elsewhere in spec.html, as a single back link.
install.html, the description says "from layout to first switch-on". It goes with step 4, so fix it if step 4 goes.

Findings, most serious first. - how.html, "That means no bundle of wires running back to one fuse board." Invents a benefit and a fuse board the site never mentions. Cut it, or say only that one cable chains the nodes. - how.html, "It is not a replacement for your fuse board or battery protection." Same problem: a safety claim nobody has made. Keep "It is not a finished product. There is nothing to buy yet." - install.html, the four steps plus "First switch-on". This is an invented install procedure. Plan, cable and fit are fair. "Power up, then check each system from the hub screen one at a time" is a made-up commissioning step. Cut step 4 or fold it into the closing note. - install.html, "plug it into the cable" and "connectors and fusing will be published". Both imply connectors and fusing exist. Say "connect it to the cable" and drop the fusing and connector promise. "Nothing here is a wiring instruction yet" is enough. - how.html lead, "lights, water, heating and climate". Heating is part of Climate, so this lists it twice. Use "lights, water and climate", or match index.html ("lights, water and heating"). - how.html, "You fit each one near the thing it controls, so wires stay short." The "stay short" benefit isn't in the brief. Drop the clause. - how.html, "The hub is the brain." This is a mild cliche and not the plain voice. Try "The hub is the main unit." - how.html, the two `arrow-link` anchors sit side by side with no wrapper, so they will probably run together or stack oddly. I haven't rendered it. Check it, or put them in a flex or `stack` row. The class is only used elsewhere in spec.html, as a single back link. - install.html, the description says "from layout to first switch-on". It goes with step 4, so fix it if step 4 goes.

Claude commented

2026-10-07 14:10:03 +00:00

Author

Collaborator

Fixed in 3507f33: dropped "so wires stay short", changed "plug it into" to "connect it to". Kept on purpose, all set by the ticket brief: the fuse board and battery protection line, the four install steps including first switch-on, the fusing note, and the "no spaghetti" claim (it is already the page h1). Kept "heating and climate" and "brain" from the brief. Arrow links render on separate lines at 400px and 1280px.

Fixed in 3507f33: dropped "so wires stay short", changed "plug it into" to "connect it to". Kept on purpose, all set by the ticket brief: the fuse board and battery protection line, the four install steps including first switch-on, the fusing note, and the "no spaghetti" claim (it is already the page h1). Kept "heating and climate" and "brain" from the brief. Arrow links render on separate lines at 400px and 1280px.

rob added 1 commit

2026-10-07 14:10:03 +00:00

Trim invented benefit and connector wording

CI / check (pull_request) Successful in 9s

Details

3507f335fd

Claude merged commit a81cfa1e51 into site-hardening

2026-10-07 14:11:26 +00:00

Claude deleted branch cc-11-content

2026-10-07 14:11:26 +00:00

Claude referenced this pull request from a commit

2026-10-07 14:11:28 +00:00