This Month in Drupal Documentation
Introducing... This Month in Drupal Documentation (TMIDD)
Similar to "This Week in Drupal Core", the relatively new Documentation Working Group (DocWG) is trying out a new communication strategy: an approximately monthly post on what is happening in Drupal Documentation. We'll be posting this both to the Core and Documentation groups on groups.drupal.org, and because it is posted to Core, comments will be disabled by policy.
If you have comments or suggestions, please see the DocWG home page for how to contact us. Thanks!
Notable Documentation Updates
- Numerous people worked on updating Drupal 8 API tutorials: https://drupal.org/developing/api/8
- hatuhay and others wrote documentation for the "League" contributed module: https://drupal.org/node/2217333
- Darren Oh and others wrote and updated documentation for the "Salsify" contributed module: https://drupal.org/node/2235183
- dnsopek and others wrote and updated contributor documentation for the "Panoply" contributed module: https://drupal.org/node/2271003
See note above on Suggestions if you'd like to be listed here in our next post!
Thanks for contributing!
Since May 1st, 206 contributors have made 783 total revisions to Drupal documentation pages on Drupal.org. Wow, thanks everyone! 7 people made at least 30 page edits each:
- Darren Oh (49 revisions)
- tvn (44 revisions)
- jhodgdon (44 revisions)
- lolandese (34 revisions)
- xjm (34 revisions)
- danylevskyi (31 revisions)
- drupalshrek (30 revisions)
In addition, there were many many commits to Drupal Core and contributed projects that improved documentation -- these are hard to count, because many commits combine code and documentation -- but they are greatly appreciated too!
Documentation Priorities
The Current documentation priorities page is always a good place to look to figure out what to work on, and has been updated recently.
If you're new to contributing to documentation, these projects may seem a bit overwhelming -- so why not try out a New contributor task to get started?
Upcoming Events
- https://austin2014.drupal.org - DrupalCon Austin - June 2-6, 2014
- http://openhelpconference.com/ - Open Help, Cincinnatti - June 14-15, 2014
- http://conf.writethedocs.org/eu/2014/unconf-berlin.html - Write The Docs, Berlin - July 19-20, 2014
Report from the Working Group
The DocWG was formed in April, and has been having meetings every two weeks to define how we'll work, and our Goals, Priorities, and Policies. In our first two months of meetings:
- We decided to meet for an hour every two weeks, for the time being.
- We set up communications procedures, which are listed on our DocWG home page.
- We made a definitive list of Goals, which are posted on https://drupal.org/governance/docwg-goals
- We're looking carefully through all of the suggestions and ideas the community has had in the past for how to improve documentation policies, procedures, and tools (and achieve our goals). We will eventually make a list of priorities. This is in progress.
- We've been talking to other individuals and working groups where our goals and responsibilities overlap, such as talking to representatives of the International Drupal community to figure out what our goals and priorities should be in the area of translating documentation.
- We've been updating the section on how to contribute to documentation at: https://drupal.org/contribute/documentation (there is more to be done there)
- We decided not to have a single "documentation team leader", and instead let the DocWG provide leadership
- We are deemphasizing the concept of the "documentation team" (which sounds like you have to be a docs expert or special team member to help out), and are instead trying to promote the concept of having the Drupal community as a whole take ownership of the documentation, and individuals take "maintainership" of parts of the documentation (more coming on that in the future).
- And... We decided to make these monthly TMIDD posts, which I'm putting into action today!