[Grok-dev] Maintenance of Community Documentation
sebastian at urbantalk.se
Mon Jun 8 04:31:29 EDT 2009
I have had some discussions with Tim Cook and Steve Schmechel and we
have agreed that we would like to put some effort into organising the
maintenance of the community docs.
If we could get peoples blessing on this we would like to do the
-Create a separate Community Doc email list [grok-doc]
The purpose would be to highlight documentation efforts and questions
related to documentation. This would be the place to go if one is
working on community documentation or has questions related to
community docs. This could also be the place where Grok users could
learn more about the capabilities of Grok by reading the discussions.
Basically we would like to support the emerging Grok culture of
learning-by-writing-docs. This would benefit everybody.
-Organise a peer review workflow. Tagging content as:
- Peer reviewed for version x.y (doc looks ok)
- Out of date (with regards to current version)
- Needs editing (for reason xyz)
- Needs merging (with content xyz)
Maybe create a simple webtool to keep track of peer reviews (if this
isn't easily implemented in Plone).
-Organise on-line sprints every three months
The purpose is to focus the community during a week to peer review and
improve community docs. If the tasks are reasonably well organised,
this could be fun and very, very useful.
If this sounds reasonable I'll be happy to take a lead on this effort.
More information about the Grok-dev