Boost logo

Boost :

Subject: Re: [boost] [random] seeding with arbitrary integers
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2009-10-23 05:08:27

> -----Original Message-----
> From: boost-bounces_at_[hidden] [mailto:boost-bounces_at_[hidden]] On
Behalf Of
> Robert Ramey
> Sent: Thursday, October 22, 2009 7:47 PM
> To: boost_at_[hidden]
> 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 A. Bristow
Prizet Farmhouse
Kendal, UK   LA8 8AB
+44 1539 561830, mobile +44 7714330204

Boost list run by bdawes at, gregod at, cpdaniel at, john at