Re: how to contribute docs

John Schinnerer <john-/Gao9/[email protected]>
Newsgroups gmane.comp.web.zope.plone.documentation
Message-ID <[email protected]>
Aloha,

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

Ditto on that...
Also agree that some other design(s) could serve better than the old ad 
hoc comments or the new no comments at all.
Ad hoc got messy and sometimes off-track; no comments really limits ease 
of providing small but essential bits of information.

Generally agree with:
> 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.

...so I think you are some kind of shared contribute/edit abilities that 
can be applied in cases where an original author no longer maintains a 
doc (by integrating comments/updating) and no other individual steps in 
to take over primary responsibility, which seems like one reasonable option.

thanks,
John S.

-- 
John Schinnerer - M.A., Whole Systems Design
--------------------------------------------
- Eco-Living -
Whole Systems Design Services
People - Place - Learning - Integration
john-/Gao9/[email protected]
http://eco-living.net

------------------------------------------------------------------------------
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.