I'd suggest that you help your fellow developers more by writing code that needs fewer comments to make it understandable.

However, I agree that what you say is certainly true of APIs.