Clarify documentation and verify what I say by adding tests.