[Asterisk-doc] Layout Suggestion

[Jared Smith]

Comments inline:

On Wed, 2004-07-14 at 20:21, Leif Madsen wrote:
> I just wanted to get a quick layout thought out in the open.
> 
> [Basic Knowledge]
> Introduction
> Installation
> Channels
> Dialplans
> Configuration Files
> Common Issues
> 
> [Advanced Knowledge]
> Advanced Asterisk Configuration
> The Asterisk Cookbook
> Scripting With AGI
> Creating Asterisk Applications in C*
> Common Issues

I'm OK with this so far...

> 
> This would split the current chapter 3 basically into two chapters. 
> This then makes the channel .conf files such as sip.conf, iax.conf,
> zapata.conf and I guess zaptel.conf(?) covered in the Channels
> chapter.  Extensions.conf is then covered in chapter 4 (Dialplans). 
> We can then cover the other .conf files in Chapter 5 (Configuration
> Files).  We can then end the basic knowledge section with common
> issues (FAQ).

I don't think this chapter 3 should cover all of sip.conf, iax.conf, and
zapata.conf.  I want this chapter to be *simple*.   It should basically
explain what channels are and how they are used.  After that, I'd rather
it just covered the *basics* of zapata.conf/zaptel.conf (just enough to
get a Devkit Light working
), and maybe iax.conf (to get an IAXtel connection going, for those
without a Devkit).  We can cover SIP and other channel types later, as
well as the details of all the .conf files.
> 
> We can then start on the Advanced Knowledge section.  I've slight
> rearranged it from its current order.  It then ends with its own
> common issues section.

Let's worry about the Advanced section of the book after we get the
Basic section done.

> 
> I can always use a little more help in writing documentation.  I'd
> like to hear people's thoughts and documentation.  If you have a few
> moments to comment it'd be appreciated.

You can count on my to open my big mouth and let you know what I think. 
What does everyone else think?  I'm hoping to get some substantial work
done between now and Astricon, so that we have something to show off. 
:-)

-Jared