Skip to content

Improve build instructions#38

Closed
MJohnson459 wants to merge 2 commits into
mainfrom
worktree-improve-build-instructions
Closed

Improve build instructions#38
MJohnson459 wants to merge 2 commits into
mainfrom
worktree-improve-build-instructions

Conversation

@MJohnson459

@MJohnson459 MJohnson459 commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Documents the mounting-grid measurements and build-instruction fixes from issue #5, on branch worktree-improve-build-instructions. Rescoped after review: the parallel fastening research (task #144 / PR #41) settled fastening direction differently from this branch's original insert recommendation, and per-joint decisions now belong to the v2 redesign process (design/REDESIGN.md, landing with PR #41) — so this PR keeps what is durable regardless.

What changed

  • design/research/mounting_survey.md (renamed from fastening.md, cut to measurements): the measured state of the committed STLs via hole_survey.py — both plates pure ORP (Ø3.5mm, exactly 20mm pitch, ~200 holes), mounts converged on a 10mm half-pitch, per-part hex-pocket census — plus the half-pitch grid rule and a caution that the census counts geometry, not usage.
  • design/research/hole_survey.py — reproducible numpy-only STL measurement (re-run after any CAD change; reused by the v2 process phases).
  • design/ASSEMBLY.md — bolt-direction/order and screw-length warnings stated up front (Pi board hazard); nyloc/threadlocker as the interim fix for bare nuts; the heat-set-insert front-runner claim removed in favour of pointers to research/fastening.md and REDESIGN.md.
  • design/README.md — the mounting-grid design decision recorded: plates pure ORP, mounts on 10mm half-pitch.
  • design/BOM.md — nyloc nuts added under In Testing; the heat-set inserts line dropped.

Verification

🤖 Generated with Claude Code

https://claude.ai/code/session_01UuQ3gEFZvHCN53EL2HdmpV

MJohnson459 and others added 2 commits July 16, 2026 23:49
Issue #5 raises three pains with the ORP-based mounting: placement
granularity, the assembly order/direction forced by captive-nut hex
pockets (with a screw-length hazard at the Pi), and nuts loosening
under vibration.

- design/research/fastening.md: measured survey of the committed STLs
  (plates are pure ORP 3.5mm/20mm; mounts already converged on a 10mm
  half-pitch with M3 hex pockets), evaluation of the issue's three
  directions plus heat-set inserts, and a recommendation: keep plates
  ORP, formalise the half-pitch mount rule, migrate pockets to heat-set
  inserts per part, reject plate re-gridding and structural clips.
- design/research/hole_survey.py: the reproducible STL measurement
  behind the survey (numpy-only binary-STL loop detection).
- design/ASSEMBLY.md: state the bolt-direction/order constraint and the
  Pi screw-length warning up front; note nyloc/threadlocker mitigation.
- design/README.md: record the mounting-grid design decision.
- design/BOM.md: nyloc nuts and M3 heat-set inserts under In Testing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016xxobY6SPF2vTt77azp297
…icts

Review of the parallel fastening research (task #144 / PR #41) settled
the direction differently from this branch's insert recommendation, and
both surveys now feed the v2 redesign process (design/REDESIGN.md, on
that branch), which decides fastening per joint. Rename fastening.md to
mounting_survey.md and cut it to what is durable here: the measured
state of the STLs, the half-pitch grid rule, and hole_survey.py. Drop
the heat-set inserts BOM line and the front-runner claim in ASSEMBLY.md;
keep the constraint warnings, the nyloc line, and the README grid rule.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UuQ3gEFZvHCN53EL2HdmpV
@MJohnson459

Copy link
Copy Markdown
Contributor Author

This isn't needed, it just adds noise.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant