27 May
2017
27 May
'17
5:33 p.m.
It's also my view that difficulties in writing documentation reflect bad design decisions. But I'm having problems convincing developers of that.
Another way of looking at this is this: if you can explain the library concisely and completely in simple documentation that makes sense to the user, then the design is likely to be a good one. Or to put it another way, writing documentation is an important part of the design process, because it flushes out the sloppy thinking that we all fall for from time to time... John. --- This email has been checked for viruses by AVG. http://www.avg.com