docs: add Contributing page with issue-tracker, PR-routing and security-reporting guidance
docs: add Shell Completion, activation steps moved off the app repo root Bash, Zsh, Fish, PowerShell and pipx activation for Click's built-in _FIRESTARTER_COMPLETE completion, plus the note on migrating off the old argcomplete-based setup. Linked from Home and listed in the sidebar.
docs: add Breaking Changes, the destination for the README version history Carries every entry from both sub-repo READMEs: the v1.32 database schema change, the AT28C VCC correction, the AT28C010 page size, v1.20's algorithm dispatch key and v1.10's COBS framing. Each keeps its hedge -- the page-size change is still stated as software-proven and unvalidated on silicon, and the VCC correction still says plainly that it fixes no write-path failure.
docs: restore the chip pin maps, lead protocols with their name Pin Maps carries all 15 chip family pin maps again. Moving them to the firmware repository was the wrong call: a pinout is what someone with a chip in their hand actually wants to look at. Only the shield's own wiring and control-register bits stay in the firmware repository, which is developer detail nobody programming a chip needs. Programming Protocols leads each section with the protocol's name and puts the number in parentheses after it.
docs: make the protocol pages user-facing Programming Protocols is now a plain description of what each protocol does and which chips it is for. Protocol ID and Protocol Flags are merged into it and deleted as separate pages. The implementation detail -- write algorithms, pulse widths, voltage routing, register constants, datasheet citations, the invariant matrix -- moves to PROTOCOLS.md in the firmware repository, linked from the top of the page. Pin Maps keeps the adapter wiring and the pin-21 warning a user acts on; the full per-family maps and shield wiring move to PINOUTS.md alongside it. Part numbers on the protocol page are now ones that actually resolve in the chip database -- the truth check caught W29C0xx filed under the wrong protocol, and several family prefixes and Dallas suffixes that were not real part numbers.
docs: cut the reference pages down to what a user needs Shield Revisions: replace the git-provenance inventory with a plain list of the real revisions and how to tell them apart. Drop the silkscreen alias table, the ADC band table and the investigation-history pointer. Capability matrix loses supported_protocol_ids, max_vcc_v and runtime_guard_gaps; notes now carry detection and jumpers. No modified or personal boards. Pin Maps replaces Pinout Safety Review and AT28C04 Adapter: socket pin maps for all 15 chip families generated from the pinout data, the DIP24 adapter reroute, and the shield's own pin and control-register assignments. Chip Database Fields replaces Infoic Field Dictionary: describes the Firestarter chip database rather than the upstream format. Protocol ID: protocol and what the algorithm is, nothing else. Protocol Flags: one bit/mask/meaning table, unknown bits included as unknown rather than guessed at. Package Details deleted -- its flags tables duplicated Protocol Flags and its own half was DIP-filter internals. SRAM and NVRAM Behavior deleted. Lockable PROMs keeps its family tables; intro tightened and tracking parameters stripped from the datasheet links.
docs: rework the front pages for a first-time reader Home: lead with what Firestarter is, then install the stable release directly. Drop the adapter and pinout-safety links; keep the protocol and chip reference sections. Link the beta last. Beta-Testing-Install -> Install-Beta: the board table now tells you how to identify your board rather than listing firmware assets and avrdude flags. Flashing cut to the command and what it does. Port-numbering note removed. Smoke test shortened. Community-Validation -> Testing-Chips, absorbing the 'help test a chip' handoff: written for a contributor rather than a maintainer, with no code references, no ladder internals and no summary table. Every claim about writing to the chip is kept in force. How-This-Wiki-Is-Published/How-To-Edit-This-Wiki deleted: with the publish pipeline retired there is no pipeline left to document. The adapter and pinout-safety pages are now reached from the protocol bucket that discusses those parts.
Rewrite Home and sidebar as the real navigation index; replace the published-model page with an editing guide
Publish wiki from in-repo source
Manual test edit (167-06 Step G, to be overwritten)
Initial Home page