Welcome! This group is for news and discussions related to Drupal documentation. If you join this group, you'll be signed up to receive email notifications; you can change your preferences on your account page. You can also subscribe to posts via RSS (check the sidebar of this page), and via email using the links at the bottom of this page.
Anyone can contribute to documentation, and the entire Drupal community will benefit from your help! You do not have to formally join a team (or this group) or ask for permission -- just start writing and editing. The Contribute to Documentation section on Drupal.org has more information, and the New Contributors section on Drupal.org has some tasks that will help you get you started.
We have a new project! We're creating a User Guide to Drupal 8. That page has information about how to participate in writing or editing, and we're posting in this group about our meetings (every two weeks) and status updates.
If you have ideas about how the processes, procedures, and tools for Drupal documentation can be improved, the Documentation Working Group (a committee that is part of the Drupal project governance structure) invites you to make suggestions. Information on how to do that is on the Documentation Working Group home page.
Neil Drumm (drumm) and I have been working lately on the API module (used to build API documnentation sites like https://api.drupal.org and others). We've made a 7.x-2.x branch of the project, which works quite differently from the 7.x-1.x branch. The major changes are that it uses a different (and external) parsing library for parsing PHP files, and it uses Composer to manage its external library dependencies.Read more
I am very pleased to announce that the English version of the User Guide is live on drupal.org, at last! You can see it at
You will also see links on the User Guide pages to Catalan and Hungarian (Magyar) versions of the User Guide. These are in-progress translations, with most images in the target language. Currently, most of the text is still in English, but more complete translations will be coming soon, since these two language teams are hard at work translating.Read more
At long last, the copy editing of the User Guide is done! (If you've been a member of this group for a while, you should know what I'm talking about; if not, go browse the archives at https://groups.drupal.org/documentation for the last 1.5 years or so). I'd like to thank everyone who helped with editing tasks, and especially Jojy Alphonso (jojyja), who did the vast majority of the copy editing. THANK YOU!Read more
It's been way too 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.Read more
We've been working on a User Guide for Drupal 8 for about a year now, and the English version is in pretty good shape -- it's in the stage now of copy editing and image refinement, and we're working on making a home for it under drupal.org/documentation. (If you are interested in helping with copy editing, see https://groups.drupal.org/node/512211 by the way -- there is still time to help!) So, it's about time to think about translating the guide to some (and hopefully, eventually all) of the 100+ languages that Drupal supports.Read more
If you've been following discussions here for a while, you're hopefully aware that for the past year, we've been working on creating a User Guide for Drupal 8, and it is coming along very well. I'd like to thank recent volunteers Anna van Raaphorst, Antje Lorch, Boris Doesborg, Charles Leverington, Grant Dunham, Jojy Alphonso, Michael Lenahan, Zach Carter, and attendees of a Spokane workshop for their help in testing the guide, updating content for accuracy, and copy editing!Read more
I was looking at the Sprints page for DrupalCon New Orleans and noticed that on the accompanying sign-up spreadsheet, there is not yet a Documentation sprint listed. (Sprints are times at DrupalCon where people get together to work on projects.) I can't complain about this too much, since I will not be at DrupalCon and will also not be available remotely to help out...Read more
We've been working on creating a User Guide -- the project page is here:
One of the things we decided early on is that it should have an index. So, as the topics were written (by a variety of people), each one was given one or more index entries. This has resulted in an index that is sort of OK, but has some problems, because it was created by many people instead of a single professional indexer. You can currently see the index (as it is now) at:
I'm pleased to announce that the User Guide has an all-but-complete first draft! (There are 3 topics that haven't been written, but they are all just about done.) So, it's time for the next phase: copy editing and testing. There were many people who, when we originally announced the User Guide project, said they were interested in helping during the editing phase -- now is your chance!Read more
A big thanks to Advomatic, who hosted a 4-hour User Guide sprint today! From my perspective, it went very well; I hope the participants will comment here with their thoughts. Oliver/oseldman organized the sprint, and he contacted me ahead of time to ask if I had any suggestions. Then they picked a time (and notified me ahead of time), so that Joe and I could try to be available in IRC while they were sprinting.Read more
This is your long awaited 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, comments are disabled. If you have comments or suggestions, please see the DocWG home page for how to contact us.Read more
Let's get ready for sprints at DrupalCon Barcelona!
Instead of meeting this week, we are moving the IRC meeting to next week, September 17. Please join us in the IRC #drupal-docs channel to get up to speed with the latest developments in the D8 User Guide.
If you are new to IRC, please see https://www.drupal.org/irc/setting-upRead more
Twice a month, we meet in the #drupal-docs IRC channel to chat about the D8 User Guide.
Do you have questions about the D8 User Guide project? Want to get involved? Need help getting started?Read more
It's been a busy month in Drupal documentation land. 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!Read more
Have questions about the D8 User Guide project? Want to get involved? Need help getting started?
Join the User Guide project team in IRC, say hello, ask any questions you might have, and get help finding a section to write.
New to IRC? See https://www.drupal.org/irc/setting-up
Edit: IRC Log attachedRead more