Skip to content

docs: v0.4.0 README/AGENTS refresh + generic type-param header#15

Merged
peczenyj merged 2 commits into
develfrom
feature/v0.4.0-docs
May 25, 2026
Merged

docs: v0.4.0 README/AGENTS refresh + generic type-param header#15
peczenyj merged 2 commits into
develfrom
feature/v0.4.0-docs

Conversation

@peczenyj

Copy link
Copy Markdown
Owner

Release-prep for v0.4.0: bring the docs in line with the new behavior, and a small
fix so generic structs render with their type parameters.

Docs

  • README diff examples updated to v0.4.0 output: type <Name> struct { and the
    (NN.NN% smaller) suffix (unified + side-by-side + quick-start).
  • Usage block lists the four new flags (-exclude, -generated, -tests,
    -skip-cache-padded) plus -version.
  • New Scanning scope section; notes that generated files and _test.go are
    skipped by default; -skip-cache-padded referenced from the false-sharing caveat.
  • Generic behavior documented (diff uses the type params' assumed sizes; inspect
    skips generics).
  • AGENTS.md refreshed (structfilter, common.Options, Finding presentation fields).
  • Screenshot verified current (regenerates identically).

Small feature

Render generic type-parameter names in the diff header — type Generic[T] struct {
instead of type Generic struct {. align captures Finding.TypeParams ("[T]",
"[K, V]") from the named type; ui prepends them. Non-generic output unchanged.

task ci green; coverage 82.8%.

… the diff

- Update the README diff examples to the v0.4.0 output (type <Name> struct { +
  "(NN.NN% smaller)"), document the four new flags in Usage, add a "Scanning
  scope" section (generated/tests/exclude/skip-cache-padded), and note the
  generic-type behavior (diff uses assumed sizes; inspect skips generics).
- Refresh AGENTS.md: internal/structfilter, common.Options scan knobs, and the
  Finding presentation fields.
- Render generic type-parameter names in the diff header, e.g.
  "type Generic[T] struct {": capture Finding.TypeParams in align (from the
  named type's TypeParams) and prepend them in ui.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@codecov-commenter

codecov-commenter commented May 25, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.21%. Comparing base (419085b) to head (1323499).
⚠️ Report is 6 commits behind head on devel.

Additional details and impacted files
@@            Coverage Diff             @@
##            devel      #15      +/-   ##
==========================================
+ Coverage   82.66%   83.21%   +0.55%     
==========================================
  Files          10       10              
  Lines         548      566      +18     
==========================================
+ Hits          453      471      +18     
  Misses         55       55              
  Partials       40       40              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Exercise the defensive early-returns (empty name, name not in scope, alias to a
non-Named type) plus single/multiple type parameters, bringing typeParamNames to
100% coverage.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@peczenyj peczenyj merged commit 05145bc into devel May 25, 2026
6 checks passed
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.

2 participants