[documentation] Help cleaning up comments

[Greg Knaddison - GVS]

On 4/7/07, Addi Berry <addi at rocktreesky.com> wrote:
> Since I became a site maintainer at OSCMS a few weeks back I have
> been on a mission to delete comments from the handbooks.  I have been
> chipping away at the list and as of writing this email there are only
> 19 pages that have more than 10 comments each to them. I have been
> deleting useless comments (thanks and support requests) and rolling
> in useful ones. There are literally hundreds (maybe 500+?) pages with
> comments and so I am asking for a little help here.

Yay for better handbooks!  Yay for Addi!  Yay docs!

I noticed that many of the remaining pages with lots of comments are
SOC proposals which have interesting discussion that is hard to delete
because it's important to maintain some of the original voice of the
authors (e.g. Boris discussing the need for Jabber modules, or
rDouglass' points about install profiles as SOC projects).  I just
wanted to suggest that in the future these should probably be
discussed somewhere that allows and promotes comments.

I think that's standard now to discuss them elsewhere, and my idea is
likely to be forgotten by spring 2008, but I wanted to share the
observation.

Thanks,
Greg