This commit resolves a non-fatal warning emitted by recent pytest
versions by explicitly listing all custom pytest marks applied by our
test suite in the top-level "pytest.ini" configuration file.
Unrelatedly, documentation and commentary throughout the codebase has
been marginally improved for consistency and readability. (Humongous humours!)