what about dynamic tables (views?) for module comparison?
I am relatively new to drupal, and i've been evaluating some Module-types like lightbox- or imagecropping- Modules.
There are quite some comparison pages, and even a list of them.
Very usefull.
But i think as static text, they will always be outdated.
So, did someone ever think about dynamic comparison tables for modules?
I'd imagine a view that can pull compatibility, installs, activity etc. directly from the projects, so they would never outdate...
Maybe that's harder than i think?
Read more
Template for Contrib documentation
Unfortunately contrib documentation sometimes seems to be few and far between. I understand this is because people are busy and a lot of people are working on Drupal modules on their own time. That being said, I think if we had a template, it would be a lot easier for people who aren't used to writing documentation and who need guidance to write documentation, and it would also bring some consistency to the documentation that is on drupal.org.
Ia anyone interested in helping me create a template for contrib module documentation?
Read more
Core API documentation issue squad needed!
For the past several years, I have been the person who has managed the documentation component of the Drupal core issue queue.
Several people besides me have recently started contributing to Drupal's API documentation by patching issues, and I'm very happy about that! What I'd like to do now is also get a few people to take on the issue queue management tasks as well.
Read moreDocumentation and Docs Team Proposed Restructuring
As a (partial) follow-up to Towards Docs Sustainability... Here is a proposal (or the beginnings of a proposal) for a major structural revision to how we do documentation on Drupal.org, and to the Documentation team.
Your suggestions and ideas are welcome! Please comment below, and then I'll go back and edit this proposal to incorporate the great suggestions I'm sure you will have.
Note: This is a work in progress, and may have been edited since you last looked at it, or since someone made a particular comment... sorry for any confusion!
Read moreCall for programmers and site builders to help with docs infrastructure!
If you are an experienced site builder, or a medium-to-experience PHP programmer, the Docs Team needs your help! We have several things that we’d like to get done that will improve the infrastructure for documentation and for contributing to documentation in the Drupal project.
EDIT: I'm marking tasks "taken" if someone has spoken up to do them.
Update Sept 23 - new tasks added!!
Update November 15 - task list edited
Site Builder Tasks
Read moreTowards Docs Sustainability
Compiling a bunch of the ideas that have come up over the last week in discussions with the Docs Team folks at Drupalcon London. It's been a running theme that the docs are no longer manageable, and some concrete suggestions to deal with that are as follows. Note they are all options and need not all be adopted, some are exclusive of others:
Read more
Learning series page
Hi all,
These days we see quiet many learning series / articles coming out on drupal.
All these are getting listed under drupal planet along with other articles as well.
Can we have a doccumentation page like we have for success stories, case studies where in we all list / aggregate feeds from all these learning series (another planet kind of page but, dedicatedly contains all the learning series / learning initiatives) ?
I am sure this will improve the ease of finding drupal related materials easily for a new comer.
Right now its hard to search these within planet.
Outline for Drupal 7 Site Building quick start guide
The Docs Team has put in a proposal to attend the Google Summer of Code Docs Summit/Sprint in October 2011. This conference includes a sprint, and we decided that we would propose building:
A quick start guide to building a Drupal 7 site (with core Drupal and contributed modules), which we've identified as a missing piece in our official Drupal documentation. (We had a beginner's suite building guide for Drupal 5, which was updated somewhat for Drupal 6, but it has issues and needs to be totally rethought.) This new quick start guide would use a fictitious company web site as an example, and go through all of the steps necessary to build a Drupal site (after the initial installation of Drupal -- we already have good documentation on that part). We would then link to this quick start guide from our Drupal documentation home page, and from other pages on Drupal.org (our intent would be for this to live on-line on drupal.org, and to be a fairly prominent piece of documentation, maintained going forward in new versions of Drupal).
What I'd like to do here is make an outline, so we're ready to get to work on this when we arrive (if our proposal is accepted).
Read moreGSoC Doc Sprint Summit
In conjunction with Google Summer of Code (GSoC), Google is hosting a "Doc Sprint Summit" at Google's Mountain View headquarters (California) 17 October - 21 October. I don't know anything about it besides what's here: https://sites.google.com/site/docsprintsummit/
The summit will consist of:
a) An un-conference on open-source documentation topics
Takin a break for summer
Hey Team -
I just wanted to let you all know I'm going to be scaling back my duties for the remainder of the summer (until DrupalCon London). I'll still be around-ish - will keep an eye on the docs queue for urgent business and probably work on some docs independently, but I won't be doing much team management until closer to the Con.
If you need my feedback on something more urgent, feel free to email me through the contact form, or leave a message for me on IRC (though I may be slower than usual to respond).
Read more