Take this README file for example. There are multiple code blocks
in here, that serve as usage examples for the user.
However, since these examples are supposed to describe what the
module does, why not go ahead and use them as the specification?