Skip to content

docs: reconcile stale GEMM perf claims with current BENCHMARKS/perf.md - #2

Merged
tannevaled merged 1 commit into
mainfrom
docs/drift-audit-2026-08-05
Aug 5, 2026
Merged

tannevaled merged 1 commit into
mainfrom
docs/drift-audit-2026-08-05

Conversation

@tannevaled

Copy link
Copy Markdown
Contributor

Summary

  • README.md's perf paragraph still cited the pre-by-lane-FMLA GEMM numbers (~156 GFLOP/s, ~76% of OpenBLAS) instead of the current, better result already recorded in docs/perf.md (tuned-BLAS parity at n=1024, ~203 GFLOP/s, ~0.99x OpenBLAS) and never mentioned the newer BENCHMARKS.md (Apple M4 Max, ~373 GFLOP/s at ~1.00x single-threaded vecLib, beats the pure-Go gonum 4-10x).
  • docs/plan-ndarray.md's "Performance" phase was still marked "IN PROGRESS" with "Still TODO: SIMD Sqrt/Max ... a tuned OpenBLAS/MKL would lead" even though those are done — updated to mirror the wording already reconciled in the sibling go-ndarray/docs repo's roadmap.md.
  • No library code touched; no perf numbers fabricated — every figure pulled in was already measured and documented elsewhere in this same repo (docs/perf.md, BENCHMARKS.md).

Test plan

  • GOWORK=off go build ./...
  • GOWORK=off go vet ./...
  • GOWORK=off go test ./...
  • Manual check: no remaining stale "156 GFLOP/s"/"76%"/"IN PROGRESS"/"Still TODO" phrases

🤖 Generated with Claude Code

README.md's perf paragraph and docs/plan-ndarray.md's Performance phase
still cited the pre-by-lane-FMLA GEMM numbers (~156 GFLOP/s, ~76% of
OpenBLAS) and listed SIMD Sqrt/Max plus the cache-blocked GEMM as
"Still TODO" / "IN PROGRESS" — all superseded once the by-lane FMLA
micro-kernel landed. docs/perf.md already records tuned-BLAS parity at
n=1024 (~203 GFLOP/s, ~0.99x OpenBLAS), and the newer BENCHMARKS.md
(Apple M4 Max) records ~373 GFLOP/s at ~1.00x single-threaded vecLib
plus a 4-10x win over the pure-Go gonum — neither of which the
top-level README or roadmap mentioned. Bring both up to date, matching
the wording already reconciled in the sibling go-ndarray/docs repo's
roadmap.md. No library code touched.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@tannevaled
tannevaled merged commit 1a4cfae into main Aug 5, 2026
9 checks passed
@tannevaled
tannevaled deleted the docs/drift-audit-2026-08-05 branch August 5, 2026 20:34
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