There has been a small group of people looking at how to use Advanced help in Drupal 6 (and the new help system in Drupal 7) to add documentation about Drupal right into a site. Last week Adam Moore (redndahead) and a small team of sprinters worked on screenshot madness with the idea that we will eventually get this sorted out. I have had a proof of concept module sitting around for a while on my desktop and now that we really seem to be getting momentum, and I inexplicably woke up at 3:30 am this morning, I finally gave it a good look over, changed some stuff and committed a very, very barebones module to CVS. This should let people be able to play with the concept on their own sites to make it more real while we figure out exactly how we want to organize it, standards we need, etc. It also gives us something tangible to make patches for and use for testing out other advanced things we need to do, like syncing it with Drupal.org handbook pages. So, here are the important bits:
- We have a new component in the Documentation issue queue, called Documentation module, to use for all issues about the module.
- I will not make an official release for this, but since I know many docs folks are not going to grab this directly from CVS, I have made a dev snapshot tarball we can use for playing to help discussion - http://drupal.org/node/402496. (For CVS users, the module is currently in HEAD, contributions/modules/documentation.)
- The code is for Drupal 6 and requires the Advanced help module. Instructions here (for now): http://cvs.drupal.org/viewvc.py/drupal/contributions/modules/documentati...
- Yes, this is code in CVS. Changes can only be made with patches and I'm the only person with commit access right now (well, except Dries ;-)). Most of the work on this for now will be discussion as we figure out how to set things up. When we get to actually filling out docs we will look at how that will happen and who can do it.
- We're not gonna go nuts filling out the docs just yet. It doesn't sync with Drupal.org yet and until we get a better temperature on the likelihood of that I'd hate to do tons of duplicative work.
Some things we need to discuss:
- What should be in the documentation module? We aren't going to be able to put the whole handbook in there. We should start small and focused and add as we go. For now, I have starter pages for cron, upgrading and terminology (these aren't even complete pages - I just grabbed the text from the existing top-level handbook pages).
- How do we want to organize this? We can have a master docs module that has sub-modules for various sections if we want. This would allow us to have different top-level sections rather than everything under "documentation." It wold also allow admins to turn off sections they don't want for whatever reason.
- What "special" standards do we need to create that are different or above and beyond the current spanky, new style guide for the D.o handbooks?
- I'm sure there are other thoughts, concerns and topics out there too. Feel free to get the discussion going - either on the mailing list (where this will also be posted) or the issue queue, using the new Documentation module component.

Comments
I'll be releasing my modules today
They include:
Using these, Jam (horncologne) and I will be starting an effort to document Drupal 6 and distribute the help+module needed to have context sensitive help in Drupal 6 (as a downloadable project) (we'll be recruiting help writers to assist with this effort)
This is a step in a possible solution for the core help strategy. It assumes that we'll end up with something in D7 that resembles advanced help in some way. It assumes that documentation is best written online in a collaborative content management system (like Drupal). It assumes that the infrastructure team would be able to run the export functions during the packaging process (and possible check the code into CVS as well - this point will generate debate).
The good news is, I'll be releasing these today, I expect. Will post back with a link.
Woot
Yay! Glad this is getting out the door. For those following along at home, here is the project for Advanced Help Injection and Export (it includes both of the book2help and helpinject modules described).
Lullabot loves you
Our O'Reilly book is out! Using Drupal
Learn Drupal online at Drupalize.me
Drupal Docs has its own project
Just as a heads-up, using the main Documentation project for the module made the queue a little weird, so with the help of dww we've moved the module into its own project on d.o. It now lives at http://drupal.org/project/drupaldocs and has its very own issue queue. :-)
Lullabot loves you
Our O'Reilly book is out! Using Drupal
Learn Drupal online at Drupalize.me