Re: how to contribute docs

On Wed, Jan 13, 2010 at 17:44, Veda Williams <[email protected]> wrote:

> Hi there John,
>
> First, comments on documents have been removed, as they were becoming
> cluttered and hard to maintain.
>

I'm dismayed by that.  Some of the most invaluable nuggets of info I've ever
found when dealing with Plone were comments added to documents on plone.org.
  I might suggest that the problem isn't that comments are 'hard to
maintain' but rather that frequently the documents themselves were utterly
abandoned, and people other than the original author were the ones keeping
the information relevant via the comment thread.

My perspective on commentable documents is that the documents are supposed
to be 'living authored content' and that the comments represent a staging
area for feedback/information that needs to be assimilated into the
document.  If the original author can't/won't do that, then the document
itself needs to be editable by those who are investing the time/energy into
adding the comments.

I totally agree that comments on the plone.org documents should not be used
as an ad hoc support forum.  But just turning off commenting wholesale
throws the baby out with the bathwater.

What good is a dynamic CMS if not for allowing documentation to be refined
over time and remain germane to its intended audience?


regards,

-David

------------------------------------------------------------------------------
Throughout its 18-year history, RSA Conference consistently attracts the
world's best and brightest in the field, creating opportunities for Conference
attendees to learn about information security's most important issues through
interactions with peers, luminaries and emerging and established companies.
http://p.sf.net/sfu/rsaconf-dev2dev

_______________________________________________
Plone-docs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/plone-docs