Comment Re:Good engineers write good documentation (Score 1) 96
All that code inside, implementing that API? Waste of time. Good commenting + unit tests will be better than any word doco. In-fact, providing a little stripped to the bones demo app, implementing each api call (with a little comment around each piece), that is built as part of your project, is better than a pdf any day of the week.
Generally though, documentation is all about who you are communicating with. Co-located team members? Waste of time. Distributed geo-location teams? Make sure the boundaries are very well documented. Selling something to be consumed externally? Document, provide examples, provide demos. Mostly it's just common sense.