docs(spec): scaffold Phase 5 deliverable stubs #34

Merged

navigator merged 1 commit from auto/issue-30-20260524T182505Z_issue30 into main

2026-05-24 15:31:35 -03:00

navigator commented

2026-05-24 15:28:51 -03:00

Owner

Files added

docs/spec/

pop-soc-v1.md — single-die chip spec
pop-accel-8-board-v1.md — 8-SoC board spec
fluidpop-isa.md — RISC-V custom ISA reference
poplink-phy-if.md — PopLink MAC ↔ PHY interface (Section 13.4)
README.md — index over the spec set

docs/benchmarks/

report-v1.md — head-to-head benchmark report
baseline-gemmini-rocket.md — stock Gemmini+Rocket baseline (Section 7)

docs/architecture/

chip-block.svg — TODO placeholder text file
board-block.svg — TODO placeholder text file

docs/funding/

grant-proposal-pacid.md — PT-BR PACID grant draft anchor
tapeout-rfq.md — EN tapeout RFQ
board-fab-rfq.md — EN board fab RFQ

Notes

docs/spec/programming-model.md already exists with substantive
Status: Draft content and is intentionally left untouched.
Each markdown stub carries H1 title, Status: Stub, Owner: TBD,
and a 2-3 line intent description.
SVG placeholders are TODO text files until real block diagrams are
designed.
Pure scaffolding — no fabricated technical claims.

Closes #30.

Scaffolds the 10 Phase 5 documentation deliverables listed in PLAN.md Section 10, plus the Section 13.4 PopLink PHY interface spec (12 files). Purpose is to anchor file paths now so cross-references in ADRs and other docs don't dangle when the content gets populated. ## Files added **`docs/spec/`** - `pop-soc-v1.md` — single-die chip spec - `pop-accel-8-board-v1.md` — 8-SoC board spec - `fluidpop-isa.md` — RISC-V custom ISA reference - `poplink-phy-if.md` — PopLink MAC ↔ PHY interface (Section 13.4) - `README.md` — index over the spec set **`docs/benchmarks/`** - `report-v1.md` — head-to-head benchmark report - `baseline-gemmini-rocket.md` — stock Gemmini+Rocket baseline (Section 7) **`docs/architecture/`** - `chip-block.svg` — TODO placeholder text file - `board-block.svg` — TODO placeholder text file **`docs/funding/`** - `grant-proposal-pacid.md` — PT-BR PACID grant draft anchor - `tapeout-rfq.md` — EN tapeout RFQ - `board-fab-rfq.md` — EN board fab RFQ ## Notes - `docs/spec/programming-model.md` already exists with substantive `Status: Draft` content and is intentionally left untouched. - Each markdown stub carries H1 title, `Status: Stub`, `Owner: TBD`, and a 2-3 line intent description. - SVG placeholders are TODO text files until real block diagrams are designed. - Pure scaffolding — no fabricated technical claims. Closes #30.

navigator added 1 commit

2026-05-24 15:28:51 -03:00

docs(spec): scaffold Phase 5 deliverable stubs

build / scalafmt-check (pull_request) Successful in 3s

Details

build / sbt-compile (pull_request) Successful in 3s

Details

build / shell-lint (pull_request) Successful in 11s

Details

dc991e18f1

Anchor file paths for the 10 Phase 5 documentation deliverables listed
in PLAN.md Section 10, plus the Section 13.4 PopLink PHY interface spec.
Each markdown stub carries H1 title, Status: Stub, Owner: TBD and a 2-3
line intent description; SVG placeholders are TODO text files until real
block diagrams are designed. Adds docs/spec/README.md as an index over
the spec set. programming-model.md already exists with Draft content and
is intentionally left untouched. Pure scaffolding — no technical claims,
no fabricated content. Lets future PRs populate each file incrementally
without arguing about paths, and keeps cross-references in ADRs and
PLAN.md from dangling. Closes #30.