Lessons (pitfalls) · lessons/01-verify-from-source.md · Markdown

01 — Verify from source

Board facts that the design depends on (connector side, voltages, designators, threads, which button is which) must come from a primary source: the schematic, datasheet photos or the vendor's 3D model. They should not come from the user's recollection or from the agent's assumptions. In this session the user's assumptions and the agent's were each wrong at least once.

Confirm which side of the board a connector is on, from photos

Read supply voltages off the schematic image, pin by pin

Re-derive designators from the schematic; name by position when the model can't tell

Infer the thread from hole sizes when nobody can tell you

Say what the sources do not tell you, and keep the label provisional

Use vendor-model bodies as proxies for missing data, and say they are proxies

Find parts by name or reference designator, never by size alone