> No shit sherlock! I admit that this is a contrived example, but you get my point. Not a contrived example. There are an absurd amount of libraries that do th

> No shit sherlock! I admit that this is a contrived example, but you get my point. Not a contrived example. There are an absurd amount of libraries that do this and call it documentation. There will be a nice, tidy example of how to use the library with a toy example. That's fine. The intro probably doesn't need to go that deep. Then I move to the technical documentation or API, and that's what they have to offer.