Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so. Because this is posted in the Core group as well as Documentation you can not comment on this post. If you have comments or suggestions, please see the DocWG home page for how to contact us.
Notable Documentation Updates
Most of the hook_help texts for the Drupal 8 core modules have been finished, but there are still a few that some review. If you can help, hop over to https://www.drupal.org/node/1908570 to find the remaining issues. Most of these help texts need to a review because they have been written over a course of two years and Drupal 8 has evolved since then. If you want to help reviewing them, check https://www.drupal.org/node/2283477.
Thanks for doocumenting
February 2015 was a extraordinary productive documentation month with 245 people revising and writing more than 1000 pages. The most active editors were:
- Pierre.Vriens (288 revisions)
- HongPong (47 revisions)
- sidharrell (32 revisions)
- Spleshka (27 revisions)
- gisle (21 revisions)
- NonProfit (18 revisions)
- Ryan Weal (16 revisions)
- lolandese (15 revisions)
- cs_shadow (14 revisions)
- webchick (14 revisions)
- benjy (13 revisions)
- lshey (12 revisions)
- tvn (11 revisions)
- colan (10 revisions)
- iampuma (10 revisions)
- juankvillegas (10 revisions)
- jhodgdon (9 revisions)
Many thanks go out to everyone that helped improving Drupal's on line documentation.
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.
The two meta issues to update and review of help texts currently have a high priority: Not only do we need them for a good user experience of Drupal 8, they also need to be translated once they are ready.
Working on them is also a good way to find out already how Drupal 8 will work for site builders and site administrators.
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
- http://montpellier2015.drupaldays.org/ - Drupal Dev Days, Montpellier (France), 14-18 April 2015
- http://frontendunited.org/ - Frontend United, Bristol (UK), 5-7 June
- https://events.drupal.org/losangeles2015 - DrupalCon Los Angeles, 11-15 May
Report from the Working Group
In February, we met with the Drupal Association's Joshua and Tatiana who presented us the ideas for the future of on line documentation on drupal.org. It seems that in the future we will be able to use several different types of documentation on drupal.org, most noticeably we will be able to have documentation that is much tighter integrated with contributed modules and themes. We were able to give useful feedback on the DA's plans and some of our long wished improvements, as outlined in https://www.drupal.org/governance/docwg-goals seem to be going to be realised. Despite that, some of our requests have not been met yet and some doubts remain over the implementation of the DA's plans.