Skip to content

docs: fix 10 documentation-codebase drifts found by audit#3692

Merged
jqnatividad merged 3 commits into
masterfrom
doc-audit-2026-04-09
Apr 10, 2026
Merged

docs: fix 10 documentation-codebase drifts found by audit#3692
jqnatividad merged 3 commits into
masterfrom
doc-audit-2026-04-09

Conversation

@jqnatividad

Copy link
Copy Markdown
Collaborator

Summary

  • Fix 10 false claims found by systematic documentation audit against codebase at commit fbbaf5f68
  • Corrects test counts (2,900/3,000 → 2,600/2,700; actual: 2,666), stale command counts in README-MCP.md table (60/66 → 62/71) and marketplace.json (66 → 70), adds pragmastat to PERFORMANCE.md OOM list, removes incorrect index icon from sortcheck, fixes binary size percentage contradiction and "the the" typo, and corrects skills README examples count (180 → 174)
  • All 8 findings from the previous audit (2026-04-07) were confirmed fixed; this audit catches regressions from those fixes plus new drift

Test plan

  • Verified test count: cargo test -F all_features -- --list = 2,666 (confirmed across two runs)
  • Verified command counts: grep -c 'Command::' src/main.rs = 71; 71 - 9 excluded = 62 for qsvmcp
  • Verified sortcheck has no index usage (grep -i index src/cmd/sortcheck.rs = no matches)
  • Verified pragmastat uses indexed() at line 573 (📇 icon correct, but was missing from OOM list)
  • Verified skill examples count: parsed all 51 JSONs = 174 examples
  • Documentation-only changes — no code modifications

🤖 Generated with Claude Code

jqnatividad and others added 3 commits April 9, 2026 16:26
- Fix test count overclaims (2,900/3,000 → 2,600/2,700; actual: 2,666)
- Fix README-MCP.md command count table (60/66 → 62/71)
- Fix marketplace.json metadata count (66 → 70)
- Add pragmastat to PERFORMANCE.md OOM list
- Remove incorrect 📇 index icon from sortcheck (2 locations)
- Fix binary size percentage contradiction (~13%/~12% → ~16%/~16%)
- Fix "the the" typo in README.md
- Fix skills README examples count (180 → 174)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…ndex

Address review #1405:
- Replace absolute paths with repo-relative paths in audit report
- Verify pragmastat 📇 icon is correct (uses indexed() at line 573)
- Test count of 2,666 confirmed across two runs with -F all_features

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jqnatividad jqnatividad requested a review from Copilot April 10, 2026 01:14
@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

TIP This summary will be updated as you push new changes. Give us feedback

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documentation-only PR that corrects a set of audited documentation/codebase drifts to keep published claims (counts, icons, and metadata) aligned with the current repository state.

Changes:

  • Updates README claims (test counts, sortcheck index icon, binary size percentages, typo cleanup).
  • Updates performance/help docs to reflect current command behavior and pinned Polars revision badge.
  • Updates Claude/MCP plugin docs and marketplace metadata to reflect current command/example counts, and adds an audit report artifact.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file
File Description
README.md Fixes inaccurate test counts, removes incorrect 📇 marker for sortcheck, resolves size percentage inconsistency, and fixes a typo.
docs/PERFORMANCE.md Adds pragmastat to the OOM/non-streaming list (🤯) to match command behavior.
docs/help/TableOfContents.md Removes incorrect 📇 marker for sortcheck and updates Polars badge revision hash.
docs/help/sortcheck.md Removes incorrect 📇 marker from the command header.
docs/help/foreach.md Removes incorrect 📇 marker from the command header.
docs/audits/AUDIT_REPORT_2026-04-09.md Adds the audit report documenting the verified false claims and applied fixes.
.claude/skills/README.md Updates the usage examples total count to match the skill JSONs.
.claude/skills/README-MCP.md Updates qsv/qsvmcp command counts in the summary table to match current code.
.claude-plugin/marketplace.json Updates marketplace metadata description command count to match the plugin description.

@jqnatividad jqnatividad merged commit 30ef7b7 into master Apr 10, 2026
5 checks passed
@jqnatividad jqnatividad deleted the doc-audit-2026-04-09 branch April 10, 2026 01:17
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