Is there any reason why the handbook pages don't have author names and timestamps? It is really annoying not to be able to tell how old something is before you start trying to implement it. Some of the handbook is extremely old and some of the comments are ancient. But at least with a comment, I can see: a) who wrote it, and b) when they wrote it.
This is a bit off-topic, more on working habits. I'm wondering if anyone here has any good recommendations for a CVS client for Mac. There are quite a few out there, and a lot of discussion elsewhere, but I'm hoping to get a sense from this group here.
As part of an effort of the Drupal doc team to improve the Drupal handbook, puregin has been restructuring the About Drupal section so that it can later be it's own book within drupal.org (the goal is to restructure the handbook into multiple books). Below, I've sketched out a potential outline for the book that in large part makes use of existing book pages while restructuring the "About Drupal" section to make it easier to navigate and better target potential Drupal newbies. After the structure, I've listed some of the rhetorical strategies for this outline.
The main "About Drupal" page would include the currently existing text and then be followed by the following page structure.
I recently implemented the "Fade Anything Technique" on my Drupal site. There are obviously many ways to do this, via theme overrides, hacks, new modules.
I opted for the "quick and dirty" way, using the following steps:
For the last several weeks the Drupal documentation team has been working to organize and create documentation. We have come up with several documentation handbooks that we believe will best meet your needs. Almost 200 of you have taken the time to tell us why you use Drupal documentation, what you need, and why you would decide to use Drupal documentation again.