Users emailing the module author to suggest changes to the documentation would be far far cooler, precisely because do few people - myself included - bother to look at annocpan when having problems.

If an author isn't receptive to such useful feedback, then I probably don't want to use his code anyway.