<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML DIR=ltr><HEAD><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"></HEAD><BODY><DIV><FONT face='Arial' color=#000000 size=2>Greetings,</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>I've been pondering this for a while
now and I have been following various threads and #drupal-support for people
finding information in the handbook. People get confused where to look for
things. I've never really had a good alternative to how it was
setup. The existing setup really just carried forward into 'seperate'
books what was there structurally before. I have pinged a few folks
offline on this and talked with Dries and Charlie. So now let's see see
what everyone else thinks. </FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>I mean, I probably know it as well as
anyone and I stumble across oddities more and more. Dated content and
such, though with the version tagging, it should help a lot. A lot of the
existing content has been rewritten by a few folks and the rest doesn't look to
be getting updated soon, so pruning (unpublishing) may be in order. If
it's stale, then let's make it go away, it may get some folks to get some new
stuff in.</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>It would be nice to do it before 4.7
too. I was thinking of suggesting .....</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>+About Drupal+<BR>Stuff bout
Drupal. At this point this stays as is. It needs a detailed going
over, but not by me at this time.</FONT></DIV>
<DIV><FONT face=Arial color=#000000 size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>+Installation /
Configuration+</FONT><FONT face=Arial color=#000000 size=2><BR>If it can be done
just by installing modules and without modifiying anything or tweaked with php
code, then it goes here (we don't need 'upgrading' as a top heading, merely a
section here). A lot of the basic standard configuration can pulled into
here. The whole modules section has developed nicely and can shine as a
major part of it. How to select and install an existing theme. Site
recipes can be moved here as well. Perhaps a link to the case studies in
the About section can be added showing how some existing sites were built
compared to any generic recipes we have. Best practices would go
here.</FONT></DIV>
<DIV><FONT face=Arial color=#000000 size=2>If anyone actually starts writing and
contributing documentation targetted at newcomers, then a newcomers config guide
would be a section here.</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>+Customization / Theming+<BR>This is
the section where you go a bit beyond the basic download. Have an intro
page with an overview of the capabilities if you know a bit of php, MySQl,
etc. Here is where all the snippets would reside. Pull the Theme
developers guide out of the Developers handbook. The theme developers
guide being in the developers handbook confuses the hell out of folks and it can
maybe help show that themeing need not be developing, but knowing a little
php or css is needed. </FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>Once people get their install going
what's the first thing they want to do? Build their own theme, not
'develop' code. Now, it will be in an obvious location.</FONT></DIV>
<DIV><FONT face=Arial size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>With the various snippets repository
in full growth, perhaps it can become a place for more articles and such.
This would be the 'advanced site admin' section and perhaps we can lure people
into entry level dev stuff without them realizing what they are
doing.</FONT></DIV>
<DIV><FONT face=Arial color=#000000 size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>+Developing for Drupal+<BR>Slight
reorg only at this point, some stuff is not well organized anymore given the
various additions. </FONT></DIV>
<DIV><FONT face=Arial color=#000000 size=2></FONT> </DIV>
<DIV><FONT face=Arial color=#000000 size=2>+About Drupal
documentation+<BR>Though this might be as well suited as a section in the About
Drupal area, it would be beyond the scope of my idea at this
time.</FONT></DIV><FONT face=Arial color=#000000 size=2>
<DIV><BR>I would be willing to do the work this weekend (or Friday), assuming I
can schedule the time with my wife. I figure a solid couple of hours to
move things (aliases would not be changed). I'd be available on IRC while
doing this. Then have a few someone's follow through with a fresh eye for
fine tuning and discussing over the rest of the weekend. </DIV>
<DIV> </DIV>
<DIV>The intro to each section would have a paragraph about how to contribute a
page and what kind of content goes into the section.</DIV>
<DIV> </DIV>
<DIV>Let me know what you all think</DIV>
<DIV> </DIV>
<DIV>-sp</FONT></DIV></BODY></HTML>