[documentation] Handbook re-org

[Steven Peck]

Huh?  I've already started implementing it.  Or did you mean something else?

On 9/15/07, Kieran Lal <kieran at civicspacelabs.org> wrote:
> Ok, documentation quality is big issue for the Drupal.org redesign.
>
> I am going to ask if we can make an instance of Drupal.org 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 Drupal.org redesign
> session attempt to implement the new categorization below.
>
> Cheers,
> Kieran
>
> On 9/4/07, Steven Peck <sepeck at gmail.com> wrote:
> >
> > Ok.  I went through several edits and misc other stuff but keep
> > running into time crunches and distractions....
> >
> > So let's just toss out broad outlines.  The first book will no longer
> > be the existing 'About Drupal'
> > We'll start with the base, "Installation and configuration".  Yes
> > there will be some cross over stuff here but we can deal with it.
> >
> > As it is designed to somewhat version specific with parts that are not
> > we can sort of split it.
> > * Getting Started *
> > - Project and features
> > - Before you start
> > - Drupal 6
> > +- Installation etc
> > - Drupal 5
> > + - Installation etc
> > - Drupal 4.7
> > + - This will contain many of the older pages that aren't getting
> unpublished.
> > -Concepts
> > - - Collected articles etc.
> >
> > BTW ( Addison's ideas were better then mine so here they are)
> > * HowTos and Snippets*
> > - HowTos
> > + - The advanced user guide
> > + - Site recipes
> > + - Theme tutorials
> > + - Contrib module HowTos
> > - Snippets (partial solutions, bits and pieces)
> > + - Introduction to the concept / use / risks
> > + - PHP Snippets
> > + - PHP Template Snippets
> > + - Contributed modules
> > - Videocasts
> >
> >
> > * Theme developers guide *
> > -Theming overview - introduce things.
> > + - Engines overview engines with a lean towards phptemplate
> > + I get fuzzy on the details after this part.  There aare differences
> > between 4.7-5.0 and 6.0.  dvessel is actually writing theme docs for
> > D6 right now separately so we have a start right there for some what
> > versioned docs.  How to integrate them in a sane manner still needs
> > some thought and response.
> >
> > * Developing for Drupal *
> > Currently I am not planning on touching this yet.  I do have some
> > ideas on it but just re-organizing two and integrating a third is
> > enough initial scope.  There are two main areas in this book though.
> > One is module development, the other is drupal.org project use and
> > maintenance of projects/cvs/etc.  So it may be good to give it some
> > thought for later.
> >
> > * Drupal Site Resources * or some such inclusive title.
> > This pulls in the stuff that was in About Drupal.
> > The About Drupal documentation goes in.
> >
> > I have more thoughts but am stopping here
> >
> > Steven Peck
> > --
> > Pending work:
> http://drupal.org/project/issues/documentation/
> > List archives:
> http://lists.drupal.org/pipermail/documentation/
> >
>
>
>
> --
> To strive, to seek, to find, and not to yield.
>
> --
> Pending work:
> http://drupal.org/project/issues/documentation/
> List archives:
> http://lists.drupal.org/pipermail/documentation/
>