Ok, documentation quality is big issue for the <a href="http://Drupal.org">Drupal.org</a> redesign.<br><br>I am going to ask if we can make an instance of <a href="http://Drupal.org">Drupal.org</a> that is upgraded to Drupal 6 to take advantage of some of the new work on the book module. If that's possible, I'll have one of the teams in my
<a href="http://Drupal.org">Drupal.org</a> redesign session attempt to implement the new categorization below.<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>