Annotated source is not documentation

Tutorials are good for beginners, but with experience a developer should be able to follow the annotated (auto- generated) documentation.

I use ruby, and for many gems there are no real tutorials, except for a short introduction on their usage. And I think even then it is pretty easy to follow the annotated-docs.