Posted: Thu Mar 19, 2009 4:45 am Post subject: [asterisk-doc] New portal for Asterisk: The Future of Teleph
Hey all,
Just wanted to let you know that we've setup a new portal for the Asterisk: The
Future of Telephony book. This site may look familiar to you if you use
Subversion; the website and tools are based on the site available from the
Subversion book guys at http://svnbook.red-bean.com. Since everything was open
source, and they are essentially working with DocBook and releasing under a
Creative Commons license, I thought it would make sense to re-utilize that
framework. So far it has worked out quite well, and only took a few hours to get
the site and HTML stuff up and running.
When we start on the third edition of the book and have something somewhat
substantial to show, we'll be sticking up snapshots of the progress on the third
edition of the book for community review.
If you have ideas of things you think are lacking in the second edition, or have
ideas of things that absolutely must be in the third edition, don't hesitate to
reply here, or contact me directly at "leif.madsen -at- asteriskdocs -dot- org".
Thanks!
Leif Madsen.
_______________________________________________
--Bandwidth and Colocation Provided by http://www.api-digital.com--
Just wanted to let you know that we've setup a new portal for the Asterisk: The
Future of Telephony book. This site may look familiar to you if you use
Subversion; the website and tools are based on the site available from the
Subversion book guys at http://svnbook.red-bean.com. Since everything was open
source, and they are essentially working with DocBook and releasing under a
Creative Commons license, I thought it would make sense to re-utilize that
framework. So far it has worked out quite well, and only took a few hours to get
the site and HTML stuff up and running.
When we start on the third edition of the book and have something somewhat
substantial to show, we'll be sticking up snapshots of the progress on the third
edition of the book for community review.
If you have ideas of things you think are lacking in the second edition, or have
ideas of things that absolutely must be in the third edition, don't hesitate to
reply here, or contact me directly at "leif.madsen -at- asteriskdocs -dot- org".
Do you think there could be an Advanced Asterisk book? Or how is the Asterisk
Cookbook coming along?
The first book leaves you very hungry for more, but then nothing fills
in that gap.
Posted: Thu Mar 19, 2009 11:45 am Post subject: [asterisk-doc] New portal for Asterisk: The Future of Teleph
Gavin Henry wrote:
Quote:
2009/3/19 Leif Madsen <leif.madsen@asteriskdocs.org>:
> If you have ideas of things you think are lacking in the second edition, or have
> ideas of things that absolutely must be in the third edition, don't hesitate to
> reply here, or contact me directly at "leif.madsen -at- asteriskdocs -dot- org".
Do you think there could be an Advanced Asterisk book? Or how is the Asterisk
Cookbook coming along?
The first book leaves you very hungry for more, but then nothing fills
in that gap.
Can you elaborate on what would be involved in an Advanced Asterisk book? What
kinds of things would you expect in such a book.
At this point, none of the authors of A:TFoT have enough time to start on a new
book, so that's why we're going to focus on updating A:TFoT to a 3rd edition.
Perhaps we can add some of the more 'advanced' things you're thinking of.
Asterisk is a vast and powerful system, but vague answers won't help us write
the book you're expecting.
Thanks!
Leif Madsen.
_______________________________________________
--Bandwidth and Colocation Provided by http://www.api-digital.com--
Gavin Henry wrote:
> 2009/3/19 Leif Madsen <leif.madsen@asteriskdocs.org>:
>> If you have ideas of things you think are lacking in the second edition, or have
>> ideas of things that absolutely must be in the third edition, don't hesitate to
>> reply here, or contact me directly at "leif.madsen -at- asteriskdocs -dot- org".
>
> Do you think there could be an Advanced Asterisk book? Or how is the Asterisk
> Cookbook coming along?
>
> The first book leaves you very hungry for more, but then nothing fills
> in that gap.
Can you elaborate on what would be involved in an Advanced Asterisk book? What
kinds of things would you expect in such a book.
At this point, none of the authors of A:TFoT have enough time to start on a new
book, so that's why we're going to focus on updating A:TFoT to a 3rd edition.
Perhaps we can add some of the more 'advanced' things you're thinking of.
Asterisk is a vast and powerful system, but vague answers won't help us write
the book you're expecting.
Yeah, sorry. Bad of me. I always assume people know what's in my head
when I write something!
3rd Edition:
1. For a start I would really like to see PRI/BRI stuff in the 3rd
edition. Even just using x-over cables.
2. Something about testing ;-) Heh.
3. Something about benchmarking and call capacities on a modern *
system. I think this may be covered already though.
Advanced:
1. An Advanced edition may cover something about OpenSIPS or Kamailio
and other sip proxies using Asterisk.
2. Linking different PBXs together.
My understanding of advanced, may be someones "beginner" and vice
versa, so I'll leave that up to you.
That's about it until it comes to a point where you'd need a book per topic.
> Gavin Henry wrote:
>
>> 2009/3/19 Leif Madsen <leif.madsen@asteriskdocs.org>:
>>
>>> If you have ideas of things you think are lacking in the second edition, or have
>>> ideas of things that absolutely must be in the third edition, don't hesitate to
>>> reply here, or contact me directly at "leif.madsen -at- asteriskdocs -dot- org".
>>>
>> Do you think there could be an Advanced Asterisk book? Or how is the Asterisk
>> Cookbook coming along?
>>
>> The first book leaves you very hungry for more, but then nothing fills
>> in that gap.
>>
> Can you elaborate on what would be involved in an Advanced Asterisk book? What
> kinds of things would you expect in such a book.
>
> At this point, none of the authors of A:TFoT have enough time to start on a new
> book, so that's why we're going to focus on updating A:TFoT to a 3rd edition.
> Perhaps we can add some of the more 'advanced' things you're thinking of.
>
> Asterisk is a vast and powerful system, but vague answers won't help us write
> the book you're expecting.
>
Yeah, sorry. Bad of me. I always assume people know what's in my head
when I write something!
3rd Edition:
1. For a start I would really like to see PRI/BRI stuff in the 3rd
edition. Even just using x-over cables.
Agreed. We'll be covering that in much detail
Quote:
2. Something about testing ;-) Heh.
Testing? Who needs testing? :-p
In all seriousness, though, we will be giving much though to the kinds
of problems that people commonly experience, and ways to address those.
Quote:
3. Something about benchmarking and call capacities on a modern *
system. I think this may be covered already though.
We do talk about this a bit, and we'll probably do a bit more of it.
That's certainly an interesting topic.
Quote:
Advanced:
1. An Advanced edition may cover something about OpenSIPS or Kamailio
and other sip proxies using Asterisk.
This is something to give some serious thought to, but the simple fact
is that all those SER-based projects are pretty complicated, and our
book (as with any book) needs to be true to it's subject. I think what
you might find us doing is giving a more thorough treatment of the SIP
protocol itself, but we'll see what time (and skill allow). It's a good
suggestion, though.
Quote:
2. Linking different PBXs together.
Yep. Good idea and one we've got on the planned outline.
Quote:
My understanding of advanced, may be someones "beginner" and vice
versa, so I'll leave that up to you.
That's about it until it comes to a point where you'd need a book per topic.
Thanks.
Thanks for the suggestions. They are all good ones, and we'll be bearing
Posted: Thu Mar 19, 2009 2:37 pm Post subject: [asterisk-doc] New portal for Asterisk: The Future of Teleph
Quote:
>> Asterisk is a vast and powerful system, but vague answers won't help us write
>> the book you're expecting.
>>
>
> Yeah, sorry. Bad of me. I always assume people know what's in my head
> when I write something!
>
> 3rd Edition:
>
> 1. For a start I would really like to see PRI/BRI stuff in the 3rd
> edition. Even just using x-over cables.
>
Agreed. We'll be covering that in much detail
Excellent. This was the part that left me feeling empty when I read
version 2. All the other news bits were great, but some only
mentioned. I appreciate how long it takes and what has to be chopped.
Quote:
> 2. Something about testing ;-) Heh.
>
Testing? Who needs testing? :-p
Say no more!
Quote:
In all seriousness, though, we will be giving much though to the kinds
of problems that people commonly experience, and ways to address those.
It's always a hard and fast moving target to address. I wish you luck.
Will this list and a wiki be used for general review?
Quote:
> 3. Something about benchmarking and call capacities on a modern *
> system. I think this may be covered already though.
>
We do talk about this a bit, and we'll probably do a bit more of it.
That's certainly an interesting topic.
Yeah. I'm sick of hearing * can only do 200 concurrent calls. Baaa....
Quote:
> Advanced:
>
> 1. An Advanced edition may cover something about OpenSIPS or Kamailio
> and other sip proxies using Asterisk.
>
This is something to give some serious thought to, but the simple fact
is that all those SER-based projects are pretty complicated, and our
book (as with any book) needs to be true to it's subject. I think what
you might find us doing is giving a more thorough treatment of the SIP
protocol itself, but we'll see what time (and skill allow). It's a good
suggestion, though.
I appreciate that too. Now IAX2 is a proper RFC, I'd like to see both SIP and
IAX2 get more details. But again, it's a trade off. Beginner book or
Advanced. Don't
want to scare people and set the barrier too high.
Quote:
> 2. Linking different PBXs together.
>
Yep. Good idea and one we've got on the planned outline.
Nice. Lot's of things can be done, but maybe just two are needed:
1. Connection/extending a system over some form of VoIP, H.323, SIP
etc. I'm thinking
about Avaya here.
2. Connection/extending a system over PRI/BRI/analogue etc.
Quote:
> My understanding of advanced, may be someones "beginner" and vice
> versa, so I'll leave that up to you.
>
> That's about it until it comes to a point where you'd need a book per topic.
>
> Thanks.
>
Thanks for the suggestions. They are all good ones, and we'll be bearing
them in mind as we go forward.
Posted: Thu Mar 19, 2009 4:51 pm Post subject: [asterisk-doc] New portal for Asterisk: The Future of Teleph
Gavin Henry wrote:
Quote:
It's always a hard and fast moving target to address. I wish you luck.
Will this list and a wiki be used for general review?
We'll probably just use this list for the general review. This time around we're
hoping that the snapshots will allow for better transparency as we write the
book, and allow more review throughout the writing process as opposed to trying
to review a whole book in a period of 2 weeks.
I don't think we'll use a wiki as the book will be written in DocBook. The
snapshots will most likely be done either after a major rework of a section, or
when we complete a milestone (like completion of a chapter). This way we can
point people to the section that changed, and all who are interested can focus
on that part specifically.
Quote:
> We do talk about this a bit, and we'll probably do a bit more of it.
> That's certainly an interesting topic.
Yeah. I'm sick of hearing * can only do 200 concurrent calls. Baaa....
Agreed! We briefly cover the benchmarking thing as you mentioned, but if we can
get a test environment setup and load test Asterisk 1.2, 1.4, and 1.6.x to show
the advanced made between the various versions, I think that will give us enough
data for a nice graph :)
Quote:
>> Advanced:
>>
>> 1. An Advanced edition may cover something about OpenSIPS or Kamailio
>> and other sip proxies using Asterisk.
>>
> This is something to give some serious thought to, but the simple fact
> is that all those SER-based projects are pretty complicated, and our
> book (as with any book) needs to be true to it's subject. I think what
> you might find us doing is giving a more thorough treatment of the SIP
> protocol itself, but we'll see what time (and skill allow). It's a good
> suggestion, though.
I appreciate that too. Now IAX2 is a proper RFC, I'd like to see both SIP and
IAX2 get more details. But again, it's a trade off. Beginner book or
Advanced. Don't
want to scare people and set the barrier too high.
One of the sections I want to expand upon is configurations and topology
scenarios to show "real life" scenarios that people often experience and have
issues with. If we can reproduce those topologies, then we should be able to
show how to configure them.
Quote:
>> 2. Linking different PBXs together.
>>
> Yep. Good idea and one we've got on the planned outline.
Nice. Lot's of things can be done, but maybe just two are needed:
1. Connection/extending a system over some form of VoIP, H.323, SIP
etc. I'm thinking
about Avaya here.
While H.323 is not very popular in North America (or Europe?), I think it is
still popular in countries of the former Soviet Union, and the like, so I think
covering this, at least in a basic, "this is how you get H.323 compiled and
configured" would be useful, but we'll be focusing mostly on SIP, and to a
lesser extent on IAX2, and H.323 lesser still.
Quote:
2. Connection/extending a system over PRI/BRI/analogue etc.
I agree here. And there is a lot more hardware available now, and is a lot more
robust, so I think covering this kind of stuff in more detail would be a welcome
addition to the book.
Thanks for the feedback!
Leif Madsen.
_______________________________________________
--Bandwidth and Colocation Provided by http://www.api-digital.com--
Gavin Henry wrote:
> It's always a hard and fast moving target to address. I wish you luck.
> Will this list and a wiki be used for general review?
We'll probably just use this list for the general review. This time around we're
hoping that the snapshots will allow for better transparency as we write the
book, and allow more review throughout the writing process as opposed to trying
to review a whole book in a period of 2 weeks.
Ok. sounds good.
Quote:
I don't think we'll use a wiki as the book will be written in DocBook. The
snapshots will most likely be done either after a major rework of a section, or
when we complete a milestone (like completion of a chapter). This way we can
point people to the section that changed, and all who are interested can focus
on that part specifically.
Ok. I'm very familiar with DocBook anyway. A bit of background, if interested:
I learned DocBook back in 2003 when doing docs for Fedora. I then joined the
Fedora Documentation Steering Committee, whilst also helping Stephan do
the Amanda doc conversion to DocBook:
I'm now part of the OpenLDAP project as docs lead, fitting in what I
can and last
year my proposal was approved by O'Reilly do an OpenLDAP Cookbook. I
haven't had chance
to bring that one to life yet though.
Anyway, I'm not blowing my own trumpet here, just pointing out that I
put my money where
my mouth is (see testing thread) and contribute when/where I can.
If you need help and reviewing etc. I'll help.
Oh, I forgot. The Fedora doc team now have a wiki->docbook converter.
Might be worth checking it
out if of interest:
I can't remember how far they are, but it's probably not O'Reilly DocBook.
Quote:
>> We do talk about this a bit, and we'll probably do a bit more of it.
>> That's certainly an interesting topic.
>
> Yeah. I'm sick of hearing * can only do 200 concurrent calls. Baaa....
Agreed! We briefly cover the benchmarking thing as you mentioned, but if we can
get a test environment setup and load test Asterisk 1.2, 1.4, and 1.6.x to show
the advanced made between the various versions, I think that will give us enough
data for a nice graph :)
Cool. No cheating though. Chuck in some transcoding!
Quote:
>>> Advanced:
>>>
>>> 1. An Advanced edition may cover something about OpenSIPS or Kamailio
>>> and other sip proxies using Asterisk.
>>>
>> This is something to give some serious thought to, but the simple fact
>> is that all those SER-based projects are pretty complicated, and our
>> book (as with any book) needs to be true to it's subject. I think what
>> you might find us doing is giving a more thorough treatment of the SIP
>> protocol itself, but we'll see what time (and skill allow). It's a good
>> suggestion, though.
>
> I appreciate that too. Now IAX2 is a proper RFC, I'd like to see both SIP and
> IAX2 get more details. But again, it's a trade off. Beginner book or
> Advanced. Don't
> want to scare people and set the barrier too high.
One of the sections I want to expand upon is configurations and topology
scenarios to show "real life" scenarios that people often experience and have
issues with. If we can reproduce those topologies, then we should be able to
show how to configure them.
Cool.
Quote:
>>> 2. Linking different PBXs together.
>>>
>> Yep. Good idea and one we've got on the planned outline.
>
> Nice. Lot's of things can be done, but maybe just two are needed:
>
> 1. Connection/extending a system over some form of VoIP, H.323, SIP
> etc. I'm thinking
> about Avaya here.
While H.323 is not very popular in North America (or Europe?), I think it is
still popular in countries of the former Soviet Union, and the like, so I think
covering this, at least in a basic, "this is how you get H.323 compiled and
configured" would be useful, but we'll be focusing mostly on SIP, and to a
lesser extent on IAX2, and H.323 lesser still.
Yeah, I just meant that that was all that was available on the Avaya
system (wow, three
thats in a sentence!).
Quote:
> 2. Connection/extending a system over PRI/BRI/analogue etc.
I agree here. And there is a lot more hardware available now, and is a lot more
robust, so I think covering this kind of stuff in more detail would be a welcome
addition to the book.
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum
FAQ
Search
Memberlist
Usergroups
Register
Profile
Log in to check your private messages
Log in
