-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Rene Rivera Sent: 27 July 2007 21:22 To: boost@lists.boost.org 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?