Re: how to contribute docs

+1 on this approach - sounds like a good balance of control and chaos... :-)

John S.

Alexander Limi wrote:
> On Fri, Jan 15, 2010 at 12:58 PM, David Hostetler <[email protected] 
> <mailto:[email protected]>> wrote:
> 
>     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.
> 
> 
> Right. The new approach is:
> 
>     * If it's in the Knowledge Base, you can edit it directly to fix
>       things (or contact the author, of course — your choice)
>     * If it's in the official manuals, you file a ticket, and the
>       editors will fix it.
> 
> It's not to discourage comments, but if you look around on other open 
> source projects, they have the same problem — comments always turn into 
> ad-hoc support and/or discussion. This confuses people that are new, and 
> annoys people that know better. For what it's worth, several other open 
> source projects are moving in the same direction (I think jQuery just 
> did the same thing to avoid the same issue).
> 
>     What good is a dynamic CMS if not for allowing documentation to be
>     refined over time and remain germane to its intended audience?
> 
> 
> Totally agree, and that's why we'll have a more open editing policy in 
> the KB area once the transition is complete. As Veda mentioned, it still 
> needs some work, and I'm as guilty as any in not finishing my redesign 
> tasks yet on the UI side of things. But it's a priority, right now I'm 
> head down in Plone 4, but hope to get to it ASAP.
> 
> -- 
> Alexander Limi · http://limi.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
> 
> 
> ------------------------------------------------------------------------
> 
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs

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