[asterisk-doc] I am new to asterisk..Please help me..

[Jim Van Meggelen]

> -----Original Message-----
> From: Austin Denyer [mailto:adenyer at ekn.com] 
> Sent: July 12, 2006 1:58 PM
> To: Discussions regarding The Asterisk Documentation Project
> Subject: Re: [asterisk-doc] I am new to asterisk..Please help me..
> 
> Jim Van Meggelen wrote:
> >>-----Original Message-----
> >>From: Tilghman Lesher [mailto:tilghman at mail.jeffandtilghman.com]
> >>
> >>I think the biggest criticism that I can level is that it was very 
> >>clear from the writing that chapters were written at 
> different times 
> >>in the development process, so while one chapter was a good 
> >>description about how things worked in 1.0, a different 
> chapter would 
> >>have new and interesting things in 1.2.  The book reads as if you 
> >>finished each chapter as a work unto itself, and when each 
> was done, 
> >>you never went back to revise it.  Hence, the book has a feel of a 
> >>collection of articles about Asterisk, rather than a unified work.
> > 
> > An interesting observation. Another factor was that the 
> chapters were 
> > written by different authors, and yes, at different times.
> 
> The problem is that Asterisk is such a rapidly moving target. 
>  Let's face it, just keeping web-based info up-to-date is 
> tough.  Throw in the delay that printing a publication such 
> as TFoT in paper book format introduces, and you're fighting 
> a lost cause.
> 
> For what it's worth, I think Jim, Leif and Jared did a 
> fantastic job with the book under the circumstances.

I appreciate the complement. I can tell you that we would have liked to have
spent a few more years on it (that's what Brian Capouch seems to be doing
with his book), but our editor was having none of it!

For sure the main goal was to speak to the folks who knew nothing about
Asterisk. We knew we would probably disappoint those folks who already had a
system running and were looking for more, but our goal was to get the total
newbie over that first hump, and by all accounts we mostly succeeded at
that.

Jim

--
Jim Van Meggelen
jim at vanmeggelen.ca
http://www.oreillynet.com/pub/au/2177

"A child is the ultimate startup, and I have three. 
This makes me rich."
                    Guy Kawasaki
--

-- 
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.1.394 / Virus Database: 268.9.10/386 - Release Date: 12/07/2006