[documentation] Handbook re-org

[Kieran Lal]

On 9/16/07, Steven Peck <sepeck at gmail.com> wrote:
>
> Huh?  I've already started implementing it.  Or did you mean something
> else?


That's great news.  I am doing a session in Barcelona,
http://barcelona2007.drupalcon.org/node/393, on the Drupal.org redesign.  It
would be good if we could explore on a test site how to take what you've
started and go a little further using the new book module.

Cheers,
Kieran


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/
> >
> --
> 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.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20070916/75a6f8c7/attachment.htm