It might be worth doing the Drupal documentation categorization exercise I did a couple years ago. We could get probably a thousand users to categorize major topics into buckets using a flash app.<br><br>My concern with these kinds of re-design efforts is they address the needs of the power users and not the 10X larger new user base.
<br><br>Cheers,<br>Kieran<br><br><div><span class="gmail_quote">On 9/4/07, <b class="gmail_sendername">Steven Peck</b> <<a href="mailto:sepeck@gmail.com">sepeck@gmail.com</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Ok. I went through several edits and misc other stuff but keep<br>running into time crunches and distractions....<br><br>So let's just toss out broad outlines. The first book will no longer<br>be the existing 'About Drupal'
<br>We'll start with the base, "Installation and configuration". Yes<br>there will be some cross over stuff here but we can deal with it.<br><br>As it is designed to somewhat version specific with parts that are not
<br>we can sort of split it.<br>* Getting Started *<br>- Project and features<br>- Before you start<br>- Drupal 6<br>+- Installation etc<br>- Drupal 5<br>+ - Installation etc<br>- Drupal 4.7<br>+ - This will contain many of the older pages that aren't getting unpublished.
<br>-Concepts<br>- - Collected articles etc.<br><br>BTW ( Addison's ideas were better then mine so here they are)<br>* HowTos and Snippets*<br>- HowTos<br>+ - The advanced user guide<br>+ - Site recipes<br>+ - Theme tutorials
<br>+ - Contrib module HowTos<br>- Snippets (partial solutions, bits and pieces)<br>+ - Introduction to the concept / use / risks<br>+ - PHP Snippets<br>+ - PHP Template Snippets<br>+ - Contributed modules<br>- Videocasts
<br><br><br>* Theme developers guide *<br>-Theming overview - introduce things.<br>+ - Engines overview engines with a lean towards phptemplate<br>+ I get fuzzy on the details after this part. There aare differences<br>between
4.7-5.0 and 6.0. dvessel is actually writing theme docs for<br>D6 right now separately so we have a start right there for some what<br>versioned docs. How to integrate them in a sane manner still needs<br>some thought and response.
<br><br>* Developing for Drupal *<br>Currently I am not planning on touching this yet. I do have some<br>ideas on it but just re-organizing two and integrating a third is<br>enough initial scope. There are two main areas in this book though.
<br>One is module development, the other is <a href="http://drupal.org">drupal.org</a> project use and<br>maintenance of projects/cvs/etc. So it may be good to give it some<br>thought for later.<br><br>* Drupal Site Resources * or some such inclusive title.
<br>This pulls in the stuff that was in About Drupal.<br>The About Drupal documentation goes in.<br><br>I have more thoughts but am stopping here<br><br>Steven Peck<br>--<br>Pending work: <a href="http://drupal.org/project/issues/documentation/">
http://drupal.org/project/issues/documentation/</a><br>List archives: <a href="http://lists.drupal.org/pipermail/documentation/">http://lists.drupal.org/pipermail/documentation/</a><br></blockquote></div><br><br clear="all">
<br>-- <br>To strive, to seek, to find, and not to yield.<br>