Over the last few years, traditional publishing has been moving closer to the web and learning a lot of lessons from blogs and wikis, in particular. Today we're happy to announce another small step in that direction: our first manuscript (Programming Scala) is now available for public reading and feedback as part of our Open Feedback Publishing System. The idea is simple: improve in-progress books by engaging the community in a collaborative dialog with the authors out in the open. To do this, we followed the model of the Django Book, Real World Haskell, and Mercurial: The Definitive Guide (among others) and built a system to regularly publish the whole manuscript online as HTML with a comment box under every paragraph, sidebar, figure, and table.
After the impressive success of the Rough Cuts program from Safari Books Online, which we've long supported, and Real World Haskell, which used a similar system, we we're extremely eager to try the idea out with more titles. Here's how Bryan O'Sullivan, one of the authors, summarized the idea once they were close to submitting their manuscript for publication:
How has our system of open, incremental development worked out? In my estimation, it has been a fantastic success, far overwhelming my expectations.
- We have received 7153 comments so far.
- That's an average of 1.73 comments per paragraph.
- The usual number of technical reviewers for a technical book is 2.
- 748 people have commented so far on our drafts.
Feedback from our readers has had a profound effect on the development of the book. We have received comments from people who have been using Haskell for almost 20 years, from casual hackers, and from people who are just picking up the language for the first time. We have used your input to make our coverage both more correct and more accessible. Thank you all for the generosity you have shown with your time and attention!
Bryan has since open sourced his Django-based feedback system as part of the development of Mercurial: The Definitive Guide. [Full disclosure: I'd pushed Bryan to open source the system as Real World Haskell was in development, but he was awfully busy at that time for some reason. I discovered that he'd done it for Mercurial instead just two days before our first OFPS alpha was ready.]
The book in question is Programming Scala, by Dean Wampler and Alex Payne. We're very grateful to them for volunteering for this project. Readers are particularly hungry for good resources on Scala itself, because the publishers are just starting to publish books about it. That relative dearth of titles combined with its unique combination of the allure of functional programming, the familiarity and power of object-oriented programming, and the stability of the JVM should make it another great test case for showing the power of involving the readers in the development of the book.