[documentation] About/Getting started/Getting involved handbooks

[Trevor Twining]

I agree; option 1 provides the focus in both use cases where it needs to be.

Brenda Boggs wrote:
> I also like option #1.  The "About" section needs to be prominent, 
> something evaluators can find very quickly, and that'd really be easiest 
> if it's in it's own section.  The description needs to be more clear on 
> what exactly is in the section.  Maybe even something along the lines 
> of, "Before You Start" rather than "About".  If nothing else, a few 
> prominent links such as a section on "What Can Drupal Do?" or what have 
> you on the main handbook page.
> 
> Brenda
> 
> Addison Berry wrote:
>> OK, so here is the last major discussion point that came out of the  
>> August 8 IRC meeting. Sorry for spamming the docs list. ;-)
>>
>> As mentioned in the Summary email we raised the subject of what do  
>> about the new Getting Involved book in relation to the existing About  
>> and Getting Started books. The two options we were discussing were:
>>
>> 1. Create the new book in addition to About. Rework the About book.
>> 2. Have the new book replace the About book. Move non-contributing  
>> kinds of things to Getting started.
>>
>> The idea/argument behind #1 is that we would retain an About book and  
>> that the contents of it would be shifted to focusing on information  
>> for "evaluator" types. This would have things like an overview of what  
>> this Drupal thing is and "marketing" stuff for lack of a better term -  
>> things like the Case studies/showcase site listing and "press" kinda  
>> stuff, if it exists. This wouldn't be a big book.
>>
>> Option #2 is to just not have an About book anymore. We would "take it  
>> over" for the new Getting Involved book and move anything that isn't  
>> for Getting Involved into the Getting Started book instead.
>>
>> My feeling is, and general IRC discussion leaned towards, option #1.  
>> The reasoning for that is that I feel like the Getting Started book  
>> should be mostly focused on actually doing stuff to get started and  
>> not have lots of extra information to sift through. I'd prefer that  
>> stuff about Drupal be in an "About" book and stuff about actually  
>> using Drupal be in the "Getting Started" book.
>>
>> We need to make a decision on this relatively soon, as we hope to  
>> launch the new Getting Involved book in the next few weeks. So, PLEASE  
>> DISCUSS.
>> --
>> Pending work: http://drupal.org/project/issues/documentation/
>> List archives: http://lists.drupal.org/pipermail/documentation/
>>   
> 

-- 
Trevor Twining
skype/AIM: trevortwining
905-228-9990 (W)