The best thing I've seen comments on documentation used for is little snippets that show how to do something that maybe isn't otherwise 100% clear, or clever ways to combine parts of the API.
Actual errors in our documentation should be reported on the Developer Issue Tracker to make sure we fix them. Also adding a comment on the matter on the docs will help people in the interim, however, but it's the DIT issue that gets it fixed.
Paul Bernhardt Application Development Consultant BlackBerry @PBernhardt
Did this answer your question? Please accept this post as the solution. Found a bug? Report it to the Developer Issue Tracker