Re: [boost] Guidelines on wiki

Subject: Re: [boost] Guidelines on wiki
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2010-03-26 11:03:21

> -----Original Message-----
> From: boost-bounces_at_[hidden] [mailto:boost-bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: Friday, March 26, 2010 1:18 PM
> To: boost_at_[hidden]
> Subject: Re: [boost] Guidelines on wiki
> 
> On 26 March 2010 12:33, Paul A. Bristow <pbristow_at_[hidden]> 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
[phone], mobile [phone]
pbristow_at_[hidden]