This Month In Drupal Documentation (March 2015)
Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so. Sorry... because this is posted in the Core group as well as Documentation, comments are disabled.
If you have comments or suggestions, please see the DocWG home page for how to contact us. Thanks!
Notable Documentation Projects and Updates
Progress is being made on [meta] Update or create hook_help() texts for D8 core modules, there are only a few child issues left before we can close that issue, and all celebrate the updated help text being ready for Drupal 8.
In addition we would love to see people putting some energy into reviewing existing help text for each of the core modules, and filing issues for anything that needs to get fixed. See [META] Review hook_help texts & copy text to drupal.org, which has some really great step-by-step instructions for doing a review. These reviews are something that you can generaly do in 30 minutes or less, and don't even require setting anything up on our localhost. So jump on in and lets knock these out.
Thanks for contributing!
Since March 1st, 2015 – 189 contributors have made 554 total Drupal.org documentation page revisions, including 9 people that made more than 10 edits -- thanks everyone! And, there are still a few days left in the month.
- Pierre.Vriens (54 revisions)
- gisle (25 revisions)
- Spleshka (25 revisions)
- Wim Leers (20 revisions)
- nedjo (17 revisions)
- NonProfit (17 revisions)
- valderama (12 revisions)
- lolandese (11 revisions)
- sidharrell (11 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
Want to help out with documentation? Do so in person at one of these upcoming events:
- Drupal Dev Days, Montpelier France: http://montpellier2015.drupaldays.org/ - 13-19 April 2015
- Frontend United, Bristol UK: http://montpellier2015.drupaldays.org/ - 5-7 June
- DrupalCon Los Angeles - https://events.drupal.org/losangeles2015 - 11-15 May
Report from the Working Group
Over the last couple of months we've been hard at work going over proposals for updates to Drupal.org put forth by the Drupal Association and other working groups. Each of the Drupal.org working groups has purview over different areas of keeping Drupal.org up and running, and figuring out how to make it even better in the future. As you can imagine, with the huge amount of documentation on Drupal.org there's a fair amount of things that touch on elements that the DocsWG helps to oversee. In our last couple of meetings we've had the opportunity to meet with members of the DA, and to talk about their 2015 priorities and roadmap. In doing so we've gotten some insight into how that will compare with the things we had outlined as priorities with regards to documentation. And begun to explore ways in which we can continue to collaborate in the future to make the process of writing, reading, and maintaining documentation on Drupal.org even better.
While it hasn't all been fun and games, both sides are working to ensure that we have better processes for communicating going forward.
This gist of it at this point is that while not everything on our list is part of their roadmap – there is a fair amount of overlap and we're looking forward to seeing how it all plays out over the coming months. That said, if you've ever felt like contributing to Drupal.org yourself there are some great opportunities to get involved with helping to improve our infrastructure. And both the DocsWG and the DA would always love the help. Reach out to any of us if you have questions.
Until next time. Happy documenting!