Asterisk, and other worldly endeavours.

A blog by Leif Madsen

Posts Tagged ‘OFPS

Debugging the Asterisk Dialplan with Verbose()

In case you missed it, Russell Bryant wrote a blog post on debugging the Asterisk dialplan with the Verbose() application. This is one of the recipes that will be features in the upcoming Asterisk Cookbook that we’re writing, and hoping to have done by the end of March!

(In case you’ve missed all the cool stuff lately, the Asterisk Cookbook will also be released under the same Creative Commons license as the previous Asterisk books. We’re also making use of the Open Feedback Publishing System (OFPS) again. You can help review the text and test the recipes at http://ofps.oreilly.com/titles/9781449303822/.)

Advertisements

Written by Leif Madsen

2011/03/04 at 9:16 am

Asterisk Cookbook Is On! (We Think :))

After finishing the first draft of Asterisk: The Definitive Guide (3rd Edition), I’ve been a bit antsy with wanting to do some more writing. After about a week of a break (i.e. sleeping in past 7am for the first time in nearly a year), Russell Bryant and I have decided to team up on delivering the long awaited Asterisk Cookbook.

To start off with, we’ll be writing a short, 80-100 page eBook that will be distributed by O’Reilly in all the formats they support (http://oreilly.com/ebooks/). The book is scheduled to have about 25 recipes, and should be written in the next 30-40 days, which would mean it should be available shortly after Asterisk: The Definitive Guide is released (which means you can bundle them together! :)).

We just finished the outline this morning and sent it off to our editor Mike Loukides. Unless O’Reilly is already booked up (pun intended?) for the next few months with production and other books, we should be starting work on this as early as next week. If all goes well after we’re done the eBook, we’ll continue expanding it with the goal of eventually releasing it as a print edition.

As a side note, we’re still accepting reviews from people for Asterisk: The Definitive Guide. We have to return all edits and changes to O’Reilly no later than February 14th, so that means you still have a couple of weeks to get some reviews and testing done! If you could make sure you have your reviews done before February 11, 2011 that would help us out tremendously as we’ll be working on getting all the edits we need done in an email to O’Reilly by Monday, February 14th. You can help out at http://ofps.oreilly.com/titles/9780596517342/.

Thanks to everyone who has contributed thus far!

Written by Leif Madsen

2011/01/27 at 9:33 am

Asterisk: The Definitive Guide, First Draft Complete!

Today we marked the finishing of Asterisk: The Definitive Guide (3rd Edition) by sending the first draft off to the O’Reilly production team. We finished nearly on schedule (within a few days, which is remarkable considering we added 150 more pages than originally intentioned) and have our favourite copy editor Rachel Head (formerly Wheeler) who did the first edition of Asterisk: The Future of Telephony who we emphatically enjoyed working with. We’re looking forward to it again.

With the draft done now, and the copy sent off to production to do their magic, I’m not quite sure what I’m going to do with my mornings! Perhaps I’ll start blogging about some dialplan stuff, or coming up with some sort of project to build. We’ll see! Any suggestions about things to document on my blog are of course welcome.

Don’t stop posting your comments and suggestions to the OFPS site though! (http://ofps.oreilly.com) When the O’Reilly production team is done with the book in a few weeks, we’re going to have time to do additional modifications and editing, so your comments will get addressed then. It’s looking like the estimated shipping date of books for March is realistic at this point.

Thanks for all the support the community has shown us this far. This is going to be by far the best book on Asterisk to date.

Written by Leif Madsen

2011/01/11 at 8:30 pm

Update for Asterisk: The Definitive Guide (3rd Edition)

It’s been a while since I’ve done an update on my blog, but that’s just because we’ve been so busy at work on the next edition of the O’Reilly published Asterisk book! Asterisk: The Definitive Guide is the next update to the Asterisk: The Future Of Telephony books and is thus the 3rd edition. We’ve changed the name for two reasons: 1) This is pretty much a complete re-write of the book based on Asterisk 1.8 and 2) Asterisk is no longer the FUTURE of telephony; it’s the present. Asterisk has made it to the mainstream!

Since the first and second editions of Asterisk: The Future of Telephony, our humble project Asterisk has come a very long way. In the first two books we were trying to convince people of this miraculous little software and that it would one day be huge. We were right. Asterisk is known in many circles and is taking the telecommunications world by storm. To try and keep up with the plethora of new features and functionality added to Asterisk over the last few years, it required us to go back and start the book from near scratch.

We’ve learned a lot about best practices and what to do and what not to do with Asterisk over the last few years, so we’ve started incorporating dialplan style into the book. We’ve tried to make things a lot more consistent in terms of what you’ll see in the dialplan examples, and they’ll be a lot more fleshed out. Some of the dialplan comes from projects we’ve worked on previously, or at the very least uses the fundamental skills we learned while working on those projects, so the dialplan examples you see should be a lot closer to production ready.

The 2nd edition of the Asterisk book ran around 500+ pages, with about 200 pages being appendices. We’ve decided to do away with the appendices in the printed book since so much of that work is being maintained by the Asterisk project directly now. With the new XML documentation being directly embedded in the Asterisk source, it’s possible for a website to exist which simply pulls and updates most of the information we had in the appendices and display the latest version online. This is where the new Asterisk Wiki comes into play (available at http://wiki.asterisk.org).

While we lost about 200 pages of appendices, that doesn’t mean the book is any lighter on content. We’ve been building PDFs of the book on a pretty consistent bases, and we’re currently up to over 600+ pages of content. That means the book is nearly twice as heavy on content as previous editions (and we’re not even done yet, and the production team hasn’t gotten their hands on it. I can honestly say I expect the book to be over 650 pages by the time it is all said and done).

My vote was simply to call the new book ‘Asterisk’ without the ‘The Definitive Guide’ moniker, but I lost that battle, so I pushed hard and said, “if the book doesn’t live up to that name, we’re going to get castrated” — and I think we’ve done that. The areas we cover and the depth of that coverage I don’t think has ever been brought together in a single book. And there are definitely tidbits of information that have never been documented, because we only found them through code review (thanks Russell! :)).

The book will be released under a Creative Commons license just like the last two editions, so nothing has changed there. What has changed is the way in which we’re having the book reviewed. We’re using the new Open Feedback Publishing System (OFPS) by O’Reilly to do a public review of the book. You can help us review the book as we write it by visiting http://ofps.oreilly.com. The first link is our book (Asterisk: The Definitive Guide) and you can also see some of the other books that are using it (we were the first to use the new edition of this software, and since then other authors have come on board, which is really quite cool to see). We try and update the book at least once a week, so keep checking back to see if your comments have been addressed, or simply check out the new content available.

Our goal is to get the first draft of the book completed by January 1st, and we’re doing pretty well with that goal being attainable. Beyond that, we’ll have about a week or two for reviewing the content, fixing any errata or suggestions from the community, and general editing review. Once that is done, the book will be sent off to production for review where they will update our graphics and do page layouts. After that, the book will be sent to the printers and will start to be distributed! People should start to see books arriving sometime in March 2011.

(For all of those who already pre-purchased books, thank you! If you’re interested in pre-ordering the book and making sure you’re one of the first to get a printed copy, see http://oreilly.com/catalog/9780596517342/)

Thanks!
Leif Madsen, Jim van Meggelen, and Russell Bryant

Written by Leif Madsen

2010/12/21 at 10:54 am