docs: improve the description of buffers

[akrzemi1]

Split into parts.
A gentler prose.

[cppalliance-bot]

An automated preview of the documentation is available at https://444.capy.prtest3.cppalliance.org/index.html

If more commits are pushed to the pull request, the docs will rebuild at the same URL.

2026-10-05 19:44:11 UTC

[cppalliance-bot]

GCOVR code coverage report https://444.capy.prtest3.cppalliance.org/gcovr/index.html
LCOV code coverage report https://444.capy.prtest3.cppalliance.org/genhtml/index.html
Coverage Diff Report https://444.capy.prtest3.cppalliance.org/diff-report/index.html

Build time: 2026-10-05 19:57:58 UTC

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.09%. Comparing base (b2dd252) to head (4d72e07).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop     #444   +/-   ##
========================================
  Coverage    98.09%   98.09%           
========================================
  Files          130      130           
  Lines         6289     6289           
========================================
  Hits          6169     6169           
  Misses         120      120           

Flag	Coverage Δ
linux	98.08% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b2dd252...4d72e07. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.