[awais-ur-rehman]

Summary

The README says every test collected by pytest repeats, but doctests run once even when --count is greater than one. Limit that statement to pytest test functions and explain the behavior for module and text-file doctests, following the documentation request in #41.

Related to #41. This documents existing behavior.

Breaking changes

None.

Testing

• On macOS arm64 with Python 3.12.13, uv run --with tox tox -e py312-pytest8,flake8: all 16 repository tests and Flake8 pass; the same test suite passes on unchanged main.
• Eight external mixed-suite probes cover module/text-file doctests and all four repeat scopes: each doctest runs once and each ordinary function runs twice with --count=2.
• Baseline and changed README render as RST without warnings; wheel/sdist builds, strict Twine checks, wheel contents checks, and git diff --check pass.
• Other Python versions, operating systems, and hosted CI were not run locally.

OpenAI Codex assisted with this documentation change and validation.