Agreed. The lack of varied examples in documentation is my common tripping point. When I hate myself, I use visit SarcasmStackOverflow to find examples, and then reference those against the module's documentation.
And it's definitely become an easier process as I've read more documentation.