This Month in Drupal Documentation
It's been way to long since we've written one of these, and a lot has happened in the last year. Yeah, that's right, it has been a year since the last "This Month in Drupal Documentation"! I can't even being to summarize the whole year in a single post, so here are some highlights of what is going on right now.
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!
Documentation Working Group Updates
It's been a while since we've had a working group meeting, though we've each been busy contributing to documentation in different ways. Despite the fact that we're not meeting regularly at the moment we're still available to help answer any questions you've got, or help out with any policy/best-practice issues. Let us know.
Notable Documentation Updates
We're recruiting maintainers for guides as they are migrated to the new documentation structure. See [#2682083] for a list of guides that need maintainers. Read about what maintaining a guide entails. If you're already maintaining a guide, thank you! Drupal is easier to learn because of it. This is the result of nearly two years of work by dozens of people, and we're super excited. I'm not going to be able to list or remember everyone that's helped with this but of note. If you see Tatiana, or any members of the Drupal Association's infrastructure team make sure you thank them for their hard work on making this possible.
Going forward I'm hopeful that we'll be able to being to highlight individual guide maintainers and the work they're doing.
Tatiana wrote a great post recently about the changes, and if you haven't been keeping up it's worth reading.
The User Guide has just completed the copy editing phase, and we will begin translating it into other languages shortly. You can read more about that here https://www.drupal.org/node/2762261. And, sign-up to help your language group with the translation.
Jennifer, and Neil have been working hard to make it possible to import the contents of the User Guide to Drupal.org. Work that will hopefully be deployed within the next couple of weeks. Once that's complete you will be able to read the User Guide in it's entirety right on Drupal.org! Super cool.
This is the result of over a year of planning, writing, editing, and coordinating by everyone involved. It's a huge achievement and I'm hopeful that it helps to set a new standard for Drupal documentation going forward.
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.
One task in particular that we could use some help with at the moment is cleaning up the titles and summaries of recently migrated documentation pages. As pages are moved into guides each one needs to have a summary written. Summaries are a one or two sentence blurb that is displayed on the main guide page helping people get a better idea of what the individual page contains. During the migration we've added quick summaries, but people who understand the material better can likely help summarize the content better. Help us make the summaries better, which helps others find the content they are after.
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?
What are you working on? Let us know and we'll help get your initiatives into the next update.
Upcoming Events
DrupalCon Dublin is this month, and Joe (@eojthebrave), and possibly others, will be in attendance. There isn't an official documentation sprint as of yet, but we'll work on getting something organized between now and then. Look for our table(s) in the official sprint room.