Documentation Is an Interface

Useful documentation helps a specific reader make a correct decision at the moment it matters.