"Andy Little" <andy@servocomm.freeserve.co.uk> wrote in message news:<drtp38$3tu$1@sea.gmane.org>...

"David Maisonave" wrote

...

What's the point of creating a great class, if only a handfull of developers ues it, because the majority have no idea how to use it?

You cant escape the fact that writing documentation is the most tedious, rotten, boring, miserable, mind-numbing job imaginable ***. Thats why so much documentation is bad or non-existent. Thats why some

library is "nearly finished" after even a couple of years "except for

the documentation", which is going to be started "very soon now"

Personally, to me the hardest part of doing documentation, is getting it started. Once I do get it started, the rest is not so painful. That's why I think it's important to have a really good template that can give developers a good starting point. One that can be a fill in the blank type.