[Asterisk-doc] "The Extensions.conf Cookbook" chapter

[Jared Smith]

Leif (blitzrage) and I were discussing how to best handle the chapter on
configuring extensions.conf.  As this is probably the most important
chapter of the book (and could easily grow to be he biggest) I'd like to
make sure the layout is right.  I want to make it *painfully* easy for
newbies to be able to follow along and get up to speed, while not making
it difficult for non-newbies to find the information they need.

So, it's up to y'all to help me come up with a good outline.  Here's my
idea so far... Feel free to rip it to shreds and toss it out the
window.  *Please*... if you have *any* opinion at all, let me know so
that we can get this chapter started!

a) Getting started with a DevKit Lite (one FXS, one FXO)
  o  Zaptel and zaptel.conf... GS/LS/KS signalling... zttool... etc.
  o  Zapata.conf... just the basics... an introduction to contexts
  o  Extensions.conf... just enough to be dangerous
b) Getting started with SIP and IAX
  o  sip.conf / iax.conf ... again, just the basics
  o  Extensions.conf... Dial()ing SIP and IAX peers
c) The other .conf files
  o  Does this belong here, or in it's own chapter? 
  o  More detailed of all the .conf files besides extensions.conf
d) Advanced extensions.conf concepts
  o  Syntax of extensions.conf
  o  More about contexts, jumping between contexts
  o  Playing with variables, introduction to astdb
  o  Macros
  o  More advanced applications
    - Playback()
    - Record()
    - GotoIf()
    - Cut()
    - Authenticate()
    - VoiceMail2
    - ZapBarge()
    - (you get the idea)
  o  A whole cookbook of recipes 


Anyway, that's what I've come up with so far... Like I said earlier, I'm
looking for comments.  (I'd especially like comments about whether to
move section 'c' above into it's own chapter, and if so whether or not
to put that chapter before or after this one!)

Jared