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

[Steven Critchfield]

Sorry for being late to this list. I apparently didn't see the
announcement of it's creation.

As for suggestions, other than the differences in arguments for Dial,
nothing else should be different in the extensions.conf file regarding
technology used. So maybe you should simplify to explaining about
variables, contexts, includes and call flow, then if you wish get into
simple examples and later into advance options. 
I think delving into any other config files in this section would not be
necessary and possibly problematic for a proofreader when anything in
those sections change. 

So maybe like below

a) Basics.
	o Contexts- why to separate
	o Includes- how to reduce typing
	o Variables- extra data
	o Call flow- putting it together
b) Samples
	o building sample company using
		1 DevKit Lite
		2 T100P and VoIP phones
		3 T400P and channel banks
		4 VoIP termination and VoIP phones
	(Of course the only differences here might be in how you address
dialing more and more users)
c)  Advanced Concepts
	o bringing in the DB
	o DISA
	o Any number of neat tricks to go along with the cookbook.


On Tue, 2003-12-23 at 14:50, Jared Smith wrote:
> 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
> 
> _______________________________________________
> Asterisk-Doc mailing list
> Asterisk-Doc@lists.digium.com
> http://lists.digium.com/mailman/listinfo/asterisk-doc
-- 
Steven Critchfield  <critch@basesys.com>