[drupal-docs] revising the existing Drupal handbook

[puregin]

On 17 May 2005, at 8:50 AM, Charlie Lowe wrote:

> I've noticed that in addition to restructuring the handboook, you are 
> revising the existing handbook pages. I'm going to jump in and start 
> revising them there, too, rather than waiting for the group to come up 
> with a clear, coherent process for all of this. Any sections that you 
> have been working on in the About section that you would like me to 
> target first? Otherwise, I'll start doing some editing/tweaking of 
> what you have already been working on.
>
> Charlie
>

    Hi Charlie - most of my 'new' contributions are
glue/placeholder text to make the revised structure
work.

I'm personally in favour of doing edits the edits
in place - Dries feels that it's not necessary to
archive the old copy.  So please, edit away! :-)

On May 9, 2005 Dries wrote:
>
>> Plan C:
>> ----------
>>      <insert your plan here :-) >
>
> I wouldn't copy anything, nor archive the old handbook. If possible,
> make the necessary preparations in the old book (like Djun has been
> doing with the <hx>-tags) before moving pages over to the new book.
> I'd think that if you move one book at a time, this could be done in a
> timely manner without being too disruptive.
>
> Am I missing the point?  Would it be a good idea to try this approach
> with the 'About Drupal' handbook?


I think it would be lovely if Anisa and Kieran
had edit privileges also - I believe Bryan already
has permissions, or?  Anyone else?  Of course,
now we actually have to talk to each other and
agree on what we're doing ;)  Though I think
that we are reaching agreement on most issues...

Everyone OK with this?  Shall we focus on the
'About Drupal' section.  Currently, it's rather
short (and should probably stay that way)

Re: the 'About' section: I've been trying to
make it much more transparent.  I am trying
to address the needs of the user who has
found her way to drupal.org in the quest for
something to help her make a website.
Not sure which persona specifically - I think
it needs to be fairly broad, hence not
very technical.

This section should help this user to figure
out
         * what is Drupal
         * can I use it to do what I need
         * what would it look like in use
         * how does it compare with other systems
         * why should I choose Drupal

etc.

I hope that this is consistent with what
has been discussed.  In any case,
I defer to your greater expertise, and
the input of Kieran's studies and analysis.

Bryan has some nice additions in
the 'new' version.  Hopefully not too
much overlap.

     Regards, Djun