[drupal-devel] creating drupal-doc teams
Charlie Lowe
cel4145 at cyberdash.com
Thu May 19 22:01:21 UTC 2005
Currently, it seems we have lots of interest in taking Drupal
documentation in new and interesting directions. To facilitate this, I'd
like to see if we can't form some documentation teams. Much like I asked
if Djun and Bryan would be in charge of reorganizing the About section
of the handbook, I'd like us to form other two person teams for any
major area that we have expressed interest in developing.
Here are just a few examples of some areas I could imagine
Documentation teams for
* Restructuring/reorganizing each of the new handbook sections as
defined on the V2 page:
http://drupal.org/handbook/v2
For example, the About the handbook section. We need a couple of people
to be in charge of our authoring guidelines and best practices for
creating Drupal handbook documentation.
(Anisa spearheaded the style guide revision; perhaps we could coax her
and one other person to handle the About the handbook section?)
* Best practices for configuring and building Druapl sites
(Roland has already volunteered for this one :) Is there another?)
* Initiatives for improving the collaborative book and other
technological solutions to improve Drupal documentation usability,
integration, and creation.
(Djun has already been working on this. Perhaps he'd like to be one of
the team members. We'd only need one other volunteer then.)
* Marketing materials
(Andre? You seem to have lots of marketing ideas :)
* Etc.
The documentation team would be responsible for most decisions regarding
their project (in some cases there might be some overlap between other
documentation teams, so they'd have to coordinate). Initially, I would
hope that each documentation team would run a proposal by the
drupal-docs list so that all of us could offer feedback in the
construction of their individual project so that a good compromise of
the important opposing interests (if any) can be reached.
Otherwise, let us know when new documentation is posted (maybe this will
be automated) so that we can offer feedback and suggestions. Or when the
documentation team members are having trouble solving an issue between
themselves, contact the list for assistance in resolution.
In the case of any who volunteer for restructuring/revising the handbook
sections, if they would like, they could also continue on as the offical
book maintainers for those new books.
If anyone has ideas for other documentation team areas, please respond
to this post via the drupal-docs list. I've mentioned a few people here,
but I'm sure there are a lot more. If anyone would like to volunteer to
be a documentation team member for a specific project, feel free to post
to the drupal-docs list or contact me privately.
Once the documentation teams have been created, I'll create a page in
the About handbook section so that people know who's in charge of
individual projects.
I hope this works well for everyone. Putting people in charge of
specific areas seems to me the best way for us to get the things we want
accomplished.
Charlie
More information about the drupal-devel
mailing list