Skip to content

docs: document human-readable units for I/O byte fields#58

Merged
navidpadid merged 1 commit into
mainfrom
docs/io-unit-formatting-a41bca343314c2b3
Apr 9, 2026
Merged

docs: document human-readable units for I/O byte fields#58
navidpadid merged 1 commit into
mainfrom
docs/io-unit-formatting-a41bca343314c2b3

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot commented Apr 9, 2026

Summary

PR #57 changed print_io_stats to format all byte-count fields with human-readable units (B, KB, MB, GB) via format_size_with_unit, and extended that helper to cover the GB range. This PR updates the docs to match.

Changed files

File Change
README.md Added note that I/O byte-count fields display with human-readable units (B, KB, MB, GB)
docs/TECHNICAL.md Added note in the I/O Stats section clarifying which fields are unit-formatted (all byte counts) vs. raw counts (syscr, syscw)
docs/TESTING.md Added unit-suffix expectation to the I/O testing checklist; added I/O Formatting Helpers subsection covering format_size_with_unit, calculate_avg_bytes_per_syscall, and calculate_io_intensity

No code changes

Pure documentation update — no source or test files were modified.

Generated by Update ProcLens Docs for issue #57 ·

PR #57 updated print_io_stats to format all byte-count fields using
format_size_with_unit (B, KB, MB, GB) and extended that helper to
support the GB range. Update docs to reflect this:

- README.md: note that I/O byte-count fields show human-readable units
- docs/TECHNICAL.md: add note clarifying which fields use unit formatting
  and which (syscr, syscw) remain raw counts
- docs/TESTING.md: document unit-suffixed output expectation for I/O
  fields and add I/O Formatting Helpers subsection covering
  format_size_with_unit, calculate_avg_bytes_per_syscall, and
  calculate_io_intensity

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Apr 9, 2026
@github-actions github-actions Bot requested a review from navidpadid as a code owner April 9, 2026 04:02
@navidpadid navidpadid merged commit 6a699f7 into main Apr 9, 2026
3 checks passed
@navidpadid navidpadid deleted the docs/io-unit-formatting-a41bca343314c2b3 branch April 9, 2026 20:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant