Posts Tagged ‘review’
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/)
Leif Madsen, Jim van Meggelen, and Russell Bryant