-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Friday, March 26, 2010 1:18 PM To: boost@lists.boost.org Subject: Re: [boost] Guidelines on wiki
On 26 March 2010 12:33, Paul A. Bristow <pbristow@hetp.u-net.com> wrote:
Daniel:
Hopefully people with subversion access will be disciplined. But I think you're right, it should be someone's responsibility to oversee the wiki and keep things ordered. I think this page demonstrates that:
https://svn.boost.org/trac/boost/wiki/Guidelines/MaintenanceGuidelines
It that a compliment or not ;-)
(I'm sure it can still be improved!)
I wasn't commenting on any of the content, but the page is a bit of a mish-mash, it needs a coherent focus. The 'user guidelines' are probably out of place, since users aren't involved in maintenance. I also don't understand why there are 'developer guidelines' and 'booster guidelines' (what's the difference?).
In the contents, 'Managing Warnings from Compilers' looks like a small subsection, but is actually half the document. It should probably be moved into a 'how to deal with warnings' article (not under guidelines), with a shorter, more general guideline on this page that would link to the article.
Agreed - It has just 'growded like Topsy': it needs an editor, guided by feedback, to keep it in some short of shape. (But that should not stop others making changes - still a wiki). Most people are polite enough to say "I've amplified/changed/deleted the section on ... - is this OK"?
Can we copy a snapshot of the wiki to the (definitely read-only) Boost site with every release?
But I don't like the idea of taking a complete snapshot at some arbitrary point. Maybe if we find that the wiki is moving to fast for whoever manages the site to keep up. But I think we should only do this for a limited number of pages, and that they should be fairly static.
I was assuming that they *are* mostly static - so a pretty-much arbitrary snapshot should be OK. Paul --- Paul A. Bristow Prizet Farmhouse Kendal, UK LA8 8AB +44 1539 561830, mobile +44 7714330204 pbristow@hetp.u-net.com