• eCommerce
  • Social and Community Suite
  • Content Management
  • RSS Extensions
  • VirtueMart Extensions
Follow us on Twitter   Join The Factory on the New Digg  
(0) | Login | Register | Lost Password?
Username: Password:  
Home
Our Products
Joomla 1.7.x  (23) & J!1.6.x
Joomla 1.5.x (28)
Joomla 1.0.x (17)
Factory Club Extensions (7)
Drupal, Elxis, MODx (6)
Windows Gadgets for J! (11)
Free Templates (4)
All Products (92)
Documentation
Tweets
Forum
Contact Us
Terms & Conditions
How to Buy Guide
Customers FAQ's
Updates & Upgrades
About Us
The Factory Demo Server for Joomla Extensions
Money Back Guarantee
Payment Methods for Joomla Extensions
Follow us on Facebook

Latest Tweets

  • Join us at the Joomladay UK!
  • The Factory Extensions Joomla Compatibility Chart
  • Love Factory 2.4 for Joomla 1.7
  • Love Factory - Memberships [VIDEO]
  • Love Factory - Custom Fields Integration [VIDEO]
  • Love Factory - Google Maps Integration [VIDEO]
  • Love Factory - Administrator Guide [VIDEO]
  • Love Factory - Memberships
  • Collection Factory for Joomla 1.6 with CB support
  • Reverse Auction Factory 1.5.9
 
   Home   Help Search Login Register  
The Factory > Forum > News & Announcements > Community News > Help Drupal to better Documentation
Pages: [1]
« previous next »
  Print  
Author Topic: Help Drupal to better Documentation  (Read 870 times)
Erik
Administrator
Hero Member
*****
Posts: 3121



View Profile
Help Drupal to better Documentation
« on: July 16, 2009, 10:32:06 am »

For the last few months myself and quite a few community members have been working on a larger vision for our beloved Drupal documentation. It has taken quite a bit longer than I had hoped, but I want to put out a draft of an initial "roadmap" for documentation that outlines our bigger issues and an approach to tackling them. I've attached a document which has everything we've hammered out so far in a 10 page document along with three appendices. This post is just a short summary of what is in that document and to let people know that we are gearing up to kick things off and really make Drupal documentation rock.

For starters, we've spent a lot of time identifying problem areas, prioritizing them and setting out some target dates. When looking at the tasks we need to accomplish we recognized that there are two main areas to focus on: the documentation itself and the community of people that create and maintain it.
Two main projects

The most important thing to put our energy into right now is to redefine the information architecture of our docs so that they are more usable. To that end, we are fortunate that Becca Scollan, who did the University of Baltimore usability testing, has offered her services to take on this crucial task. Becca will be leading the charge in this effort and we will be looking for help from all areas of the Drupal community to provide information, legwork and feedback to drive it forward. In the next few weeks we will be launching a "stakeholder interview" process where we will need community members to interview each other about their experiences with documentation. We'll add more information about this to the Content architecture section of the Community initiatives Docs roadmap.

The other initiative we are starting today is to improve the recognition of documentation efforts and find out better ways to communicate with and support people who want to help. There is a short survey posted at http://docs.drupaltest.org that we'd love to have everyone fill out so we can start important conversations about how to recognize the people behind the docs.
Communication

Speaking of conversations, this isn't something that can be successfully pushed forward by just a handful of people. The documentation is a community resource and we all owe it to ourselves to invest in making it better. Everyone is encouraged to be part of this process. make your voice be heard and get your ideas out there. The main channels for communication we will be using are those that are familiar to our community. We will use the documentation mailing list for discussions and hashing out plans, while we use the documentation issue queue for our tasks. To have a central place to organize some of these tasks, we will make use of the Community initiatives section of Drupal.org, much like Drupal core has. There is a Documentation roadmap section where we can create "landing" pages for folks interested in working on particular areas.

There is an IRC meeting in #drupal-docs on the Freenode network scheduled for Tuesday, June 16 at 17:00 GMT 18:00 GMT (darn it, sorry, this should be 18, not 17). The meeting will be an open time to discuss the roadmap, ask questions and start organizing things. Feel free to drop by and join the conversation.

We will make announcements about new work and calls for help on the mailing list and on the Documentation team group page, which you can follow with RSS. Please join in and be part of making Drupal documentation the best it can be and serve all of us better.

http://drupal.org/node/488070
Logged
Pages: [1]
  Print  
« previous next »
 
Jump to:  

Loading...
Joomla Extension - RSS Factory Manager  Joomla Extension - EBook Factory  Joomla Extension - Briefcase Factory  Joomla Extension - Auctions Factory  Joomla Module - RSS Contextual  Joomla Module - Exchange Factory (Europe / EURO)  Joomla Module - Exchange Factory (Romania/ RON)  Joomla Custom Extensions Development   Free Joomla Extensions  Joomla Extension - RSS Factory Pro (Enhanced Version)  Joomla Virtuemart Payment Plugin - Gecad (EPayment.ro)  Joomla Module - Mosimage / Image Module  Joomla Extension - Reverse Auction Factory (Lowest Bidder Auctions)  Joomla Extension - Article Factory Manager  Joomla Module - Lavalamp Menu  Joomla Module - RSS Image Extractor  Joomla Module - Exchange Factory (Europe / EURO) for Joomla 1.0.15  Joomla Module - Exchange Factory (Romania / RON) for Joomla 1.0.15  Joomla Module - Top Movies (IMDB)   Joomla Module - EBay Latest Auctions  Auction Factory Standalone PHP script