[drupal-docs] Moving handbook to docs.drupal.org

[Boris Mann]

On Thu, 17 Mar 2005 08:06:50 +0100, Dries Buytaert <dries at buytaert.net> wrote:

> Are we sure the 'pros' are worth it?  Admittedly, I'm not really
> convinced they are.  I wonder what problems we are solving.
> 
> My question: what are the _problems_ we are trying to solve, and how
> does moving the handbook help?

Without a "clean slate", it will be very, very difficult to bring
documenbtation to an acceptable level.

Already external documentation on Bryght, CS, and DevSeed is much,
much better at answering people's questions and solving their problems
than the handbook is. With the current state of the handbook, the
information from those three sources would be very difficult if not
impossible to integrate.

Much like we have not been afraid to change code/APIs if it makes
things better for Drupal code, I believe we need to do the same with
the Drupal handbook.

Shane has done a good job of explaining -- this is not an all or
nothing, but rather a kind of "best of" where we have a place to make
a fresh start. My list of pros and cons were by no means complete --
rather meant to start discussion, which is what we're having.

--
Boris Mann
http://www.bryght.com