Re: how to contribute docs

Hi John,

The idea is that the kb will be mostly open edit and so if people have a
comment, per se, they just update the document themselves. And, there will
be a link to submit tickets to the doc team in the manuals. We¹re just not
done with the migration that will allow for all of this, but it¹s in
progress.... The goal is to make sure these nuggets get incorporated, but
that the responsibility doesn¹t necessarily fall on the original author to
maintain the docs.


On 1/15/10 12:58 PM, "David Hostetler" <[email protected]> wrote:

> 
> 
> 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
> <http://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 <http://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
> 
> 


--
Veda Williams
Web Developer
Groundwire
206.286.1235x23
[email protected]
http://groundwire.org

ONE/Northwest is now Groundwire!

------------------------------------------------------------------------------
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