-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Robert Ramey Sent: Thursday, October 22, 2009 7:47 PM To: boost@lists.boost.org Subject: Re: [boost] [random] seeding with arbitrary integers
Robert Ramey wrote:
Also, I found the documentation not good enough in general. I did make it work but it wasn't as easy to use as I would have hoped. Of course I could make the same criticism for many or most libraries.
I agree strongly with this - mentioning no names to protect the guilty ;-) Thin documentation is still major barrier to use of many Boost libraries. We all need to do better - and reviewers need to consider documentation more when considering libraries. But there is still a chicken and egg problem. Few people are going to write good documentation for other people until they are confident that they will have an audience. So I repeat my view that we need a two stage acceptance process. First that the library is fundamentally acceptable, and second that cosmetic aspects and documentation are good enough. Paul --- Paul A. Bristow Prizet Farmhouse Kendal, UK LA8 8AB +44 1539 561830, mobile +44 7714330204 pbristow@hetp.u-net.com