Welcome! This group is the main location for news and discussions about what Drupal community members are doing to improve 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.
The Documentation Team leadership also puts out quarterly status posts that appear in the Drupal.org home page news (these posts are meant for the entire Drupal community, not just the Documentation Team). The Drupal.org home page news has an RSS feed too.
You can find more information about how to contribute to documentation on Drupal.org. There's also information there about the Documentation team leadership and other means of communication. Join us!
Call for Community Docs Moderator volunteers
UPDATE July 2012: If you want to be a Community Documentation Moderator, you can get started without reading this whole discussion! The instructions are now at:
http://drupal.org/node/1588928
--- Here's the original discussion post... ---
Read more
Panelists for "Structured Content Authoring" session at Design for Drupal Boston?
One of the important challenges facing the effort to improve Drupal as tech comm tool is getting the right user experience for authors especially when we start adding things like conditional text, single-sourced content and DITA-style mapping.
Read moreNot one, but TWO, sprints in Portland!
I wanted to let everyone know that there will be two sprints immediately after Drupalcon Portland: a doc team sprint focused on the Drupal.org content, followed the next day by a sprint focused on evolving Drupal as a technical communication CMS.
Doc Team Sprint - Friday, May 24
Read moreOpen Help conference
There's a conference coming up in Cincinnati Ohio USA that might be of interest for Drupal Docs folks, in June:
http://openhelpconference.com/
I probably won't be able to attend (just got back from "WriteTheDocs" in Portland), but it sounds interesting.
Drupal Docs Sprint Weekend
This doc sprint is timed to coincide with and support the various Sprint Weekend events (http://groups.drupal.org/node/277768) which are taking place on March 9 and 10. This will allow attendees at any of those local events to also be a part of a global doc sprint.
There's plenty of work to be done, including general activity on the issue queue:
https://drupal.org/project/issues/documentation
Getting started on the Drupal 8 docs:
https://drupal.org/project/issues/search/documentation?issue_tags=d8docs
Or performing the heroic work of cleaning up comments:
Read more
Docs session at upcoming ApacheCon
ApacheCon NA 2013 is February 26th – 28th, in Portland Oregon. There is a "Documentation: Don't be Afraid" session Tuesday 2:45 p.m.–3:45 p.m. http://na.apachecon.com/schedule/presentation/135/
Just a heads up in case anyone in the area wanted to attend.
Write the Docs Conference in Portland in April
There's a conference coming up in Portland called "Write The Docs". I don't know much about it (Lee tweeted it on the @drupaldocs Twitter feed so I thought I'd post here too)...
They have a web site:
http://conf.writethedocs.org/
and Twitter:
https://twitter.com/writethedocs
I'm considering going, depending on the cost, logistics, etc., since Portland is not too far away from where I live. How about anyone else?
Drupal 8 Docs: Some Thoughts
With feature freeze for Drupal 8 approaching quickly, I thought it might be a good time to raise the thorny subject of what can/should/will/might be done to update the core documentation on d.o and the online help. At a bare minimum, it would be useful to at least articulate the scope of the work and perhaps identify priorities and challenges.
Read more
Drupal 7 Managed File Form API
For managed_file form API the Properties: #prefix and #suffix does not work.
GSoC Docs Sprint Camp
This is an announcement I received today by email... I met some of last year's attendees at this event, and they all said it was great!
The Documentation Group also applied last year to do a book, and we weren't selected. I'm personally not interested in putting together a proposal for this year (especially since I'm not the Docs Team Leader any more), but if there's a group that wants to make a proposal, you might discuss that here to coordinate. You'd need to make sure to have several people who are free to attend on those dates.
Anyway, here's the announcement:
Read more
PNW Drupal Summit Docs BoF
For those of you who will be attending the Pacific Northwest Drupal Summit, who would have an interest in participating in a Docs BoF/sprint? I'm new to the Docs team, but I wouldn't mind organizing this (whenever the summit site gets BoFs up and running!). I also wouldn't mind helping someone out if they've got more experience in organizing a BoF of this type.
Thoughts?
Introduction to automation for content checking
This message has been cross posted to Drupal.org Improvements, Documentation Team, and Drupal.org Testing Infrastructure.
tl;dr
I want to use automation to improve d.o content quality. I do not have access to do this and I have been unable to get someone with access interested enough to get this project moving.
The long version
My vision for improving the Drupal Documentation and drupal.org can be broken into three equally important ideas:
Read more
Display Suite Documentation
I finished writing Documentation for Display Suite:
http://drupal.org/node/644662
(And all child pages)
This initiative was discussed here: http://drupal.org/node/1791210
Feel free to help a hand by reviewing the text & making changes where necessary.
Cheers!
BDD Testing Community Demo
The BDD testing team has been working to make the transition from Drupal 6 to Drupal 7 (and all future improvements) as smooth as possbible. Join us on Monday, September 10 at 7am PDT / 10am EDT for a demonstration of just a few of over 100 feature tests, learn how you can get involved, and pick up great ideas for quality assurance for your own client projects!
The demo will last no more than 30 minutes with an additional half-hour for questions and answers.
A brief background on BDD:
- What it is
- How it can be used, and how it is being used on Drupal.org
Documentation Team Leadership Change
A little over 18 months ago, Ariane K. and I started our tenure as co-leaders of the Drupal Documentation Team. We spent a lot of time working on organization, design, processes, and tools to make it easier for Drupalists to contribute to and use Drupal documentation, and I’m very proud of the many improvements we were able to make (of course, with the help of lots of other contributors!) during that time.
Read moreDocumentation Office Hours July 17
See when this meeting happens in your time zone.
Join the Documentation Team for our regular "office hours" meeting in the #drupal-docs IRC channel. We usually meet on the first Tuesday of the month at 9 AM US/Pacific time and the third Tuesday of the month at 4pm US/Pacific time to discuss:
Read moreDocumentation Office Hours July 10 (note non-standard date!)
See when this meeting happens in your time zone.
Join the Documentation Team for our regular "office hours" meeting in the #drupal-docs IRC channel. We usually meet on the first Tuesday of the month at 9 AM US/Pacific time and the third Tuesday of the month at 4pm US/Pacific time... This month, we'll skip July 3rd (close to US national holiday) and instead meet on July 10th. At office hours, we usually discuss:
Read more
Multi-lingual documentation?
Can the Community Media documentation be translated to other languages? Once the Comminuty Media theme is ready for its first official release I'm thinking of maybe translating some documentation to Swedish, for other Swedish channels to use Drupal and Community Media.
Wanted: Feedback for docs writers
The other day at the docs office hours, it occured to me that there really is no good way of knowing how documentation you put in the docs wiki is received. I didn't think much more about it then, but the thought has grown and I now think it's a serious problem.
(When I say "feedback" I don't necessarily mean written statements, but also things like usage statistics.)
Feedback serves two really important purposes:
- It's a motivator. When you see that things you created (or participated in creating) are being used, it's encouraging.
Documentation Office Hours June 19
See when this meeting happens in your time zone.
Join the Documentation Team for our regular "office hours" meeting in the #drupal-docs IRC channel. We usually meet on the first Tuesday of the month at 9 AM US/Pacific time and the third Tuesday of the month at 4pm US/Pacific time to discuss:
- Writing and editing Drupal documentation -- you can help!
- Improving infrastructure and tools for Drupal documentation -- your input is valuable!
- Volunteering and recruiting volunteers for Drupal Documentation
