Repoint two firmware doc links at firestarter_fw
docs: add generated provenance footers to six migrated pages (phase 173, D-09)
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: point the firmware reference links at beta main is 525 commits behind beta on the firmware repository, so a link into main would not resolve for a long time. beta is where work actually lands. These resolve once firestarter#57 merges.
docs: point issue reporting at the tracker that is actually open Issues are disabled on both firestarter and firestarter_app; only firestarter_prom accepts them. The install page was sending people to two trackers that cannot receive a report.
docs: state the Rev 0/1 limitation concretely, drop an unverified JP4 claim The limitation is now stated as what happens: a 32-pin chip above 64 KB gets the un-dropped VPE rail on pin 1 instead of the dropped 13 V. 64 KB is the boundary because A16 is asserted from address 65536 upward. Removes the claim that the TI parts take VPP on a different pin than the JEDEC parts. It is false for the 2516, which uses the 2716 pinout with VPP on pin 21 exactly as the JEDEC part does.
docs: shield revision limitations into a notes column Drops the chip-variants column. The Rev 0 and Rev 1 32-pin VPP limitation and the Rev 2.2/2.3 JP4 reroute are stated per row instead of in a section below.
docs: shield revisions by chip variant, with the Rev 0/1 VPP limitation Replaces the protocol-id column with what each revision can actually program. JP4 corrected to 1x3 on Rev 2.2 and Rev 2.3, which is what reaches the TI 2516 and 2532 VPP pin. Records the Rev 0 / Rev 1 limitation, traced to source: the VPP drop control and address line A16 are the same physical bit on those revisions, so the firmware strips the drop bit for 32-pin parts and the dropped rail is unavailable to them. Rev 0 also has no VPP readback at all.
docs: shield revisions as a technical table Restores the supported protocol list, adds a jumper column and a detection column stating what each board carries on A3. Adds the A3 band table the firmware actually branches on, and records that Rev 2.0, 2.1 and 2.2 share the low band and all report as Rev 2.0.
docs: keep the address-line count as a column on shield revisions
docs: merge the two shield revision tables into one The two tables shared their key column and largely duplicated each other -- both carried the R41 value and the JP4 footprint. Merged into one, with the separate auto-detected yes/no column dropped: what detection depends on is already in the row. Chip families, maximum VPP and address-line count were identical in all six rows, so they are stated once above the table rather than repeated eighteen times.
docs: put the logo on every page Five pages were missing the header block -- the ones written or rewritten during this pass rather than migrated from a repository that already had it.
docs: pin map headings lead with the chip, adapter section moved to the end Each pin map is now titled by the chip family it is for, with the layout reference in parentheses after it. The adapter section follows the pin maps rather than preceding them, since it applies to two families out of fifteen.
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.
fix(168): de-frame Pinout-Safety-Review for public readers Remove GSD-phase jargon a public reader cannot parse: the section heading and the before/after table column headers no longer name a phase number, and the deferral no longer points at an unopenable planning document. Every table cell is byte-identical; no claim changed.
fix(168-11): restore source wording on Shield-Revisions claim line
Rewrite Home and sidebar as the real navigation index; replace the published-model page with an editing guide
Migrate 12 documentation pages from firestarter/doc and firestarter_app/doc Copied byte-for-byte from the pre-deletion sub-repo commits recorded in tools/wiki/MIGRATION-TABLE.md, then edited within a bounded set: page title, removal of unopenable .planning/ paths, cross-file link repair to page titles, a firestarter-claim-stamp against the current chip database, and a firestarter-claims-begin/end region around the three tables whose claims this milestone's checkers will resolve against that database. The two GSD-framed pages (Pinout-Safety-Review, SRAM-and-NVRAM-Behavior) are de-framed: no phase-number title suffix, no audit-trail pointer into an unopenable path, their safety content otherwise intact. PY32F071-FIRMWARE-INSTALL.md is deliberately not migrated (deferred). Home.md and the sidebar are untouched by this commit; a later push updates their navigation once WIKI-05's live-orphan failure has been captured against this state.
Publish wiki from in-repo source
Manual test edit (167-06 Step G, to be overwritten)
Initial Home page