From: Paul A Bristow (pbristow_at_[hidden])
Date: 2007-07-28 15:23:45
>-----Original Message-----
>From: boost-bounces_at_[hidden]
>[mailto:boost-bounces_at_[hidden]] On Behalf Of Rene Rivera
>Sent: 27 July 2007 21:22
>To: boost_at_[hidden]
>Subject: Re: [boost] [Important] Boost moving to Subversion on
>Tuesday, July 31st
>
>> I prefer the ease-of-use of a Wiki. My hypothesis is that,
>if we make
>> it really, really, really easy to make improvements to that
>developer-
>> centric documentation, we'll get better at keeping it
>up-to-date and
>> relevant.
>
>Wikipedia has proven that idea impractical. Easy editing
>doesn't produce
>better docs, just more of them. You need editors, review, etc. to get
>better docs.
I have to disagree - I find Wikipedia an excellent source - provided you don't expect perfection - but where do you get that?
I find the Boost documentation is often really lacking user feedback - the things that *users* really want to know. I think a wiki
system will prodvide a lot that the authors are incapable of providing - they know too much!
But the authors can still provide the editing function and I would like the 'release' to include their latest edited version.
Paul
PS I still think the thing we are really, really missing is an indexing/searching facility. so many times I have wanted to know
something, but even knowing I have read it before, I struggle to find it. Google may help us here, but I would like to see us
providing our own indexing tool. Anyone have any ideas on how to use the quickbook docs (or html or pdf?) to provide this?