"David Abrahams" <dave@boost-consulting.com> wrote in message news:<uvevxlggc.fsf@boost-consulting.com>...
"David Maisonave" <dmaisonave@commvault.com> writes:
I think there would be 10 times more boost users, if the boost developers put the same quality into the documents, as they do into the code. It would also help developers, if boost had a really GOOD
template to do this, and it would serve as a check list for required/recommended documentation.
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?
A short while ago we created the position of Boost Documentation Wizard to help address this issue (http://lists.boost.org/Archives/boost/2005/09/93946.php), (http://lists.boost.org/Archives/boost/2005/10/96025.php). Unfortunately, I think Rob Stewart just became too busy to make the contribution he wanted to. Perhaps you'd like to step up?
Actually, I would rather invest the time in creating an automated documentation wizard.
"David Maisonave" <dmaisonave@commvault.com> writes:
"David Abrahams" <dave@boost-consulting.com> wrote in message news:<uvevxlggc.fsf@boost-consulting.com>...
"David Maisonave" <dmaisonave@commvault.com> writes:
I think there would be 10 times more boost users, if the boost developers put the same quality into the documents, as they do into the code. It would also help developers, if boost had a really GOOD
template to do this, and it would serve as a check list for required/recommended documentation.
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?
A short while ago we created the position of Boost Documentation Wizard to help address this issue (http://lists.boost.org/Archives/boost/2005/09/93946.php), (http://lists.boost.org/Archives/boost/2005/10/96025.php). Unfortunately, I think Rob Stewart just became too busy to make the contribution he wanted to. Perhaps you'd like to step up?
Actually, I would rather invest the time in creating an automated documentation wizard.
Great! Any contribution that you can make will have a huge impact. What do you have in mind, if I may ask? -- Dave Abrahams Boost Consulting www.boost-consulting.com
participants (2)
-
David Abrahams -
David Maisonave