Sounds like a great idea! I'll gladly help if requested (I'm a technical writer).

Comment: I don't see anything on echo cancellation. That's a big enough and common enough issue that it deserves some discussion.

--Ernest

At 10:46 AM 11/21/2003, you wrote:

Hi Steven,

I think this is a great idea and the best way to make
users more familiar with Asterisk and its configuration and usage.
I can and will provide input for all H.323 related sections.

Michael.

Steven Sokol wrote:
> Asterisk Users
>
> In an attempt to help Asterisk move forward, a number of us have decided
> to create a book.  It would initially be released as an "ebook" that
> could be sent to newbies to help them up the rather steep learning
> curve.  Ultimately I would like to see it published and sold in
> bookstores (preferably by O'Reilly & Co.).
>
> Below is the outline for the book.  We REALLY need as much input as we
> can get.  I would like to completely flesh-out the outline, then I would
> like to start accepting submissions from the user community for each of
> the sections/chapters/topics covered in the outline.
>
> I have to stress here that I AM NOT AN ASTERISK GURU.  I need help from
> the real gurus (especially: Steven Critchfield, John Todd, Tilghman
> Lesher, Olle Johansson, and where possible/necessary Mark and Martin).
>
> If this works, it will help Asterisk achieve the same kind of global
> success as Apache, Samba, and other Linux staples.  If you want to chat,
> I am lurking in the #asterisk-doc channel on Freenode IRC.  I'm
> 'ssokol'.  Others on this project (so far) are Jared Smith and Leif
> Madson.
>
> A "living" copy of this outline can be found at:
> http://www.sokol-associates.com/outline.htm .  I will try to update it
> daily with your suggestions.  It will also be the basis for the project
> outline (completion %, assignments, etc.).
>
> Thanks,
>
> Steve Sokol
> Sokol & Associates, LLC
>
> [Outline Guide]
> The following outline describes the layout for the book.
>
> 1. <- Section
>       a. <- Chapter
>               1) <- Sub-Chapter
>                       i.  <- Topic Heading
>                       *.  <- Sidebar Heading
>                       1}  <- Graphic or Chart
>                       1>  <- Table
>
> [Outline]
> 1.  Introduction to Asterisk
>       a.  Introductory letter from Mark Spencer
>               1)  Whatever Mark has to say...
>               2)  Digium Reference Information
>                       i.  Web Site
>                       ii. Phone Number
>       b.  The Business Case For Asterisk
>               [Somebody From The Business Side Writes This]
>       c.  General concept of asterisk
>               1) Asterisk: Swiss Army Knife of Telephony
>               2) PBX, IVR, ACD
>               3) What To Expect
>                       i.   Asterisk Is Not A Turnkey System
>                       ii.  Don't Like It?  Change It Yourself.
>                       iii. Opensource, GPL and LGPL Licensing
>       d.  Asterisk architecture
>               1)  The Big Picture
>               2)  Channels
>               3)  Codec Conversions
>               4)  Etc.
>       e.  Key components
>               1) Asterisk software
>                       i.   Asterisk (Main PBX & Channels)
>                       ii.  Zaptel (Drivers for Zaptel Hardware)
>                       iii. Libpri (ISDN PRI Drivers for Zaptel)
>               2) Zaptel Hardware
>                       i.   Overview
>                       ii.  X100P - Single Port FXO Line Interface
>                       iii. S100U - Single Port FXS USB Interface
>                       iv.  TDM400P - 4 Port FXS Analog Interface
>                       v.   T100P - Single Span T1/E1 Interface
>                       vi.  TE410P - Quad-Span T1/E1 Interface
>               3) Channels
>                       i.   Zaptel Devices/Channels
>                       ii.  The IAX Protocol
>                       iii. SIP
>                       iv.  MGCP
>                       v.   Skinny
>                       vi.  H323
>               4) Applications
>                       i.   Dial and Other Basics
>                       ii.  Voicemail
>                       iii. Dial-Plan Scripting
>               5) Extensibility
>                       i.   AGI
>                       ii.  Custom Applications
>       f.  Add-On/Optional Components
>               1) Software
>                       i.   Gnophone
>                       ii.  VoIP Soft Phones
>                       iii. DIAX
>                       iv.  Gastman
>                       v.   Open H.323
>               2) Hardware
>                       i.   VoIP Hard-Phones
>                       ii.  VoIP Gateways
>                       ii.  Channel Banks
>
> 2.  Installing Asterisk
>       *.  Asterisk Quickstart
>               1)  Install PC Hardware
>               2)  Download Asterisk Software
>               3)  Build Asterisk
>               4)  Install Asterisk
>               5)  Configure Autostart
>
>       a.  Requirements
>               *)  Picking A Solid System
>               1)  PC Hardware Requirements
>                       i.   SOHO/Residential System
>                       ii.  Small Business System
>                       iii. Medium Business/Small Call-Center System
>                       iv.  Enterprise System
>                       v.   VoIP Carrier System
>               2) Linux Requirements
>                       *.   Linux Installation Is Not Covered
>                       i.   Tested Distributions
>                       ii.  Minimum Kernel Version
>                       iii. Required Packages
>                       *.   Other Operating Systems
>                               - Free BSD
>                               - Mac OS-X
>                               - BeOS?
>                               - Win32/Win64?
>       b.  Hardware Installation
>               1)  IRQ Sharing Issues
>               2)  Digium Wildcard Cards
>               3)  LineJack and PhoneJack Cards
>               4)  Other Cards (ISDN, VoiceTronix, Etc.)
>       c.  Downloading Asterisk from CVS
>               1)  What is CVS?
>               2)  The Asterisk "Versioning" Issues
>               3)  Your Initial Download
>               4)  Updates
>               *.  Adding Custom Patches (patch/diff)
>       d.  Compiling Asterisk
>               *)  Why Do I Have To Compile The Code?
>               1)  Using 'make'
>               2)  Compiling The Software
>                       i.   Zaptel
>                       ii.  Libpri
>                       iii. Asterisk
>               3)  Making The Samples/Demo
>               4)  Making Code Documentation (Doxygen)
>                       i.   Why build code documentation?
>                       ii.  What Is Doxygen?
>                       iii. Code Doc Layout
>               5)  Common Build Errors/Warnings
>                       i.   Via C3 Is NOT An i686
>                       ii.  Building on Little-Endian Systems
>                       iii. Etc.
>       e.  Loading drivers (zaptel/ztdummy)
>               *)  Read Ahead (Section 3, Chapter C1) For Zaptel Setup
>               1)  Linux Kernel Loadable Modules
>               2)  Using modprobe
>               3)  Adding zaptel modules to your startup file
>               *)  RedHat Is Weird
>       f.  Starting Asterisk
>               1)  Manual Starting and the CLI
>               2)  Starting using safe_asterisk
>               3)  Accessing the CLI when Asterisk Is Running
>               4)  Logging/Tracing and Verbose
>       g.  Configuring Autostart w/ safe_asterisk
>               1)  Linux Runlevels (the init sequence)
>               2)  Modifying The Startup Manually
>               *)  RedHat Is Still Weird
>
> 3.  Basic Asterisk Configuration
>       *.  Overview Of Asterisk Configuration
>               1) System Layout
>               2) Configuration Files
>               3) Command Line Interface
>       a.  File Layout (The Asterisk Directory Structure)
>               1) /etc/asterisk
>               2) /var/lib/asterisk
>               3) /var/spool/asterisk
>               4) Etc...
>       b.  .conf files
>               1) What Is A .conf File?
>               2) Common File Structures
>               3) Reloading Asterisk Configuration
>       c.  Configuring Phones & Channels
>               1)  The zapata.conf File
>                       [All About zaptel/tormenta configuration]
>               2)  The IAX.conf File
>                       i.  ?? - Anbyody Know This Well?
>               3)  The sip.conf File
>                       i.   The General Section
>                       ii.  Supported Codecs/Codec Order
>                       iii. Registration of "peers"
>                       iv.  SIP Device Entries
>                       v.   Unsupported codecs/G729.a/b
>                       vi.  Common SIP Devices
>                               a)  Cisco 79XX Phones
>                               b)  Cisco ATA-186 Adapter
>                               c)  Grandstream Phones
>                               d)  SNOM Phones
>                               e)  Xten X-Lite/X-Pro
>                               f)  SoftJoy SJ-Phone
>                       *.   Asterisk and 'Reinvite'
>               3)  The oh323.conf File
>                       i.  ?? - Anybody Know This Well?
>               4)  The skinny.conf File
>                       i.  ?? - Anybody Know This Well?
>               5)  CAPI/ISDN?
>                       i.  ?? - Anybody Know This Well?
>       d.  Configuring Applications
>               1)  Music On Hold: The moh.conf File
>                       a) Don't Forget The Timing (Part A)
>               2)  Voicemail: The voicemail.conf File
>                       a) Basic SMTP Configuration
>               3)  Meet-Me:  The meetme.conf File
>                       a) Don't Forget The Timing (Part B)
>       e.  Configuring Your Dialplan
>               *)  The Dialplan: Center Of The System
>               1)  Everything Is An Extension
>               2)  Basics Of Pattern Matching
>               3)  Keeping It All In Context
>               *)  Security, Toll-Fraud and Asterisk
>               4)  Creating Outbound Calling "Extensions"
>               5)  Creating User (Station/Channel) Extensions
>               6)  Creating Application Extensions
>       f.  Sample Configurations
>               [LOTS OF SAMPLES HERE]
>
> 4.  Common Issues
>       a.  Music On Hold/MP3 Playback
>               1) Proper Version of MPG123
>               2) Zaptel Timer or Ztdummy
>       b.  DTMF Over SIP
>               1)  Inband Only Works On G.711 MuLaw/ALaw
>               2)  SIP-INFO
>               3)  RFC___?
>               4)  The "Flash"
>       c.  Internationalization of Asterisk
>               1)  Tones and Ringback
>               2)  Call Supervision
>       d.  SIP and NAT
>       e.  Optional/Added Codecs
>               1) G.729
>               2) G.723
>       f.  Message Waiting Indication
>       g.  SIP Service Provider Issues
>               1) Free World Dialup (FWD)
>               2) Iconnect
>               3) Sipphone
>               4) NuFone
>       h.  Common Hardware Device Issues
>               1) Grandstream BT100 Series
>               2) Cisco ATA-186
>               3) Cisco 79XX Series Phones
>               4) SNOM VoIP Phones
>               5) Carrier Access Channel Banks
>       *.  How to politely use the Asterisk-Users List
>       *.  How to politely use the Asterisk IRC channel
>
> 5.  Advanced Asterisk Configuration
>       a.  Agents and the Asterisk ACD
>       b.  Text-To-Speech: Festival
>       c.  CLASS Features (John Todd?)
>       d.  Fax (Software Fax)
>       e.  Sphinx Speech Recognition (ASR)
>
> 6.  Scripting And AGI Extensions to Asterisk
>       a.  What Is AGI?
>       b.  What Languages Can I Use
>       c.
>       AGI In: c, perl, php, etc.
> 7.  Creating Asterisk Applications In C
>
> 8.  Appendicies
>       a. Sources Of Additional Information
>               1) Digium Site/Asterisk Site
>               2) The Asterisk WiKi
>               3) The Asterisk-User and Asterisk-Dev Lists
>               4) The #Asterisk IRC Channel
>       b. Glossary of Asterisk & Telecom Terms
>               [Large Glossary Of Asterisk & Telecom Terms]
>       c. Applications Reference
>               [Detailed Explanation Of All "Standard" Applications]
>       d. CLI Commands Reference
>               [Detailed Explanation Of All CLI Commands]
>       e. Manager Commands Reference
>               [Detailed Explanation Of All Manager Commands/Events]
>       f. The Asterisk C API Reference
>               [Some Detail On The ast_ functions]
>
>
> _______________________________________________
> Asterisk-Users mailing list
> [EMAIL PROTECTED]
> http://lists.digium.com/mailman/listinfo/asterisk-users


_______________________________________________ Asterisk-Users mailing list [EMAIL PROTECTED] http://lists.digium.com/mailman/listinfo/asterisk-users

_______________________________________________ Asterisk-Users mailing list [EMAIL PROTECTED] http://lists.digium.com/mailman/listinfo/asterisk-users

Reply via email to