Skip to content

docs: fix README accuracy errors - #353

Merged
avoidwork merged 3 commits into
masterfrom
docs/fix-readme-accuracy
Sep 26, 2026
Merged

avoidwork merged 3 commits into
masterfrom
docs/fix-readme-accuracy

Conversation

@avoidwork

Copy link
Copy Markdown
Owner

Summary

Corrects four factual errors in README.md that were verified against the actual library, test suite, and package scripts.

Type of Change

  • Documentation update

Related Issues

N/A

Testing

  • Verified test count by running the full suite: 255 tests pass (was documented as 149)
  • Verified source line counts via wc -l src/*.js: filesize.js 286, helpers.js 538, constants.js 82
  • Verified npm run lint passes (oxlint + oxfmt)
  • Verified npm run build succeeds (pre-commit hook ran rollup)

Checklist

  • npm test passes
  • npm run build succeeds
  • 100% test coverage maintained
  • No hardcoded secrets or credentials introduced
  • Zero external dependencies added
  • ES Modules only (no CommonJS in src/)
  • JSDoc comments added/updated
  • CHANGELOG.md updated (if applicable)

Changes

  1. Test count: 149 tests → 255 tests (actual suite count)
  2. Line counts: filesize.js 285→286, helpers.js 215→538, constants.js 81→82
  3. npm run dev: "Development mode with live reload" → "Build distributions in watch mode" (it's a rollup watch, not a dev server)
  4. npm run lint:fix → npm run fix (the lint:fix script doesn't exist)

- Correct test count from 149 to 255
- Update source file line counts (filesize.js 286, helpers.js 538, constants.js 82)
- Fix npm run dev description (watch mode, not live reload)
- Correct npm run lint:fix to npm run fix
- Reposition as 'a popular choice' (filesize trails bytes and pretty-bytes
  in downloads, so 'most popular' would be inaccurate)
- Fix Standards section: standard wins over base; IEC does not require base: 2
- Add a Standards comparison table (base + symbols + example)
- Clarify round vs precision precedence
- Move TypeScript section after Usage, keep examples verified
- Tighten prose: concrete benefits over vague claims
Drop the 'popular choice' framing and the download-count claim from the
intro. State what the library is and who it serves, without a number that
would drift over time.
@avoidwork
avoidwork merged commit ee86b8b into master Sep 26, 2026
2 checks passed
@avoidwork
avoidwork deleted the docs/fix-readme-accuracy branch September 26, 2026 22:01
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