[documentation] The handbook organization

[Steven Peck]

But we come back to the 'everyone thinks it's a great idea' but no one
is doing it problem.  I don't care which it is as long as someone does
something .....

-sp 

> -----Original Message-----
> From: documentation-bounces at drupal.org 
> [mailto:documentation-bounces at drupal.org] On Behalf Of Gary Feldman
> Sent: Friday, September 01, 2006 8:57 AM
> To: A list for documentation writers
> Subject: Re: [documentation] The handbook organization
> 
> Steven Peck wrote:
> > The barrier to writing tutorials is less then screen casts. 
>  However, if
> > there are tutorials, they can be converted into screen 
> casts by others.
> > Even if there are video's, a written tutorial that 
> accompanied it would
> > be valuable.
> >   
> Valuable is an understatement.  I'd say mandatory.  In addition to 
> reasons I just recently posted, a good video needs a script - 
> not actual 
> dialogue, but enough to identify every point that should be 
> covered, in 
> order of presentation.  Few people can talk extemporaneously for any 
> length and have it come out with the polish and coherence 
> needed for a 
> video.  And once you have a script like that, you already have the 
> outline of the tutorial, which is the hardest part. 
> 
> If you start out with a tutorial, and it gets reviewed, then 
> the video 
> will be even better, as long as no one tries to read the tutorial out 
> loud, word-for-word. 
> 
> Gary
> 
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
> 
>