Re: Proposal to manage documentation similar to (or along with) core software.
Alex Clark <[email protected]>
| Newsgroups | gmane.comp.web.zope.plone.documentation |
|---|---|
| Organization | ACLARK.NET, LLC |
| Message-ID | <[email protected]> |
On 2010-04-14, JoAnna Springsteen <[email protected]> wrote: > Excellent summary Israel! > > What aclark has proposed is really nothing new. We've been talking > about doing this since the google doc sprint in 2007. The goal for the > past few years has always been to release up to date docs when a new > release of Plone is sent out. Right, but up to date docs != versioning. We have not *versioned* and *released* docs to date. That needs to start happening now with Plone 4 IMO, so that by the time Plone 5 rolls around we can look back and say "Ahhhh, these are the docs we shipped with Plone 4". > The key issue here is getting people to commit to volunteering and > then ensuring they follow through with their committments. > 1-2 hours a > week is an under-estimate of the effort required. Documentation is > time intensive and it will always be a moving target, as Israel > mentions. > A lesson learned to keep in mind is that no matter what plans you make > or how much you formalize the process, if you can't get people to > follow through on what they say they will do, you can't make progress. Pay the release manager and the doc team will either deliver, or suffer the consequences. ;-) > j. > > ------------------------------------------------------------------------------ > Download Intel® Parallel Studio Eval > Try the new software tools for yourself. Speed compiling, find bugs > proactively, and fine-tune applications for parallel performance. > See why Intel Parallel Studio got high marks during beta. > http://p.sf.net/sfu/intel-sw-dev -- Alex Clark · http://aclark.net Author of Plone 3.3 Site Administration · http://aclark.net/plone-site-admin ------------------------------------------------------------------------------ Download Intel® Parallel Studio Eval Try the new software tools for yourself. Speed compiling, find bugs proactively, and fine-tune applications for parallel performance. See why Intel Parallel Studio got high marks during beta. http://p.sf.net/sfu/intel-sw-dev _______________________________________________ Plone-docs mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/plone-docs