When “contribution” isn’t “code”

"Open source development" is vastly more about the openness of the development that the openness of the source. This can be confusing, and may be at the root of some of the classic first-encounter confusions.

A great exploration of the point has just surfaced in a totally non-code area: O'Reilly Media and authors are pioneering an "open source publishing" system. They're really excited about the results, and you might be surprised at how thoroughly their success parallels the successes of the best of open-source software.

Basically what they've done is to make early drafts of their books available on line, with an in-line comment system. As each draft goes out and draws comment, they incorporate the feedback into the book. The authors remain the authors: while I'm sure they'll find some way to acknowledge their over 700 reviewers, they're not changing the names on the cover. This work is most similar to the "Commercial Open Source" model discussed in my "Open core, open complement" post.

But whatever the structure, the open sourcing is a resounding success:

  • 7000 comments
  • 700 reviewers, where most technical books might have only 2 
  • comments from every relevant demographic, from highly experienced to neophyte 

Have these reviewers provided actual publishable content? Probably in some cases, but many also have contributed by comments as vague as "I have no idea what you're trying to say, here." They're all valuable; they all save the authors tremendous effort; they all make the result a better book.

Every open-source software project needs this kind of contribution: real and potential users guiding the way. How accessible a given project is to actual code contribution can vary widely, but your potential-commenter community is always just exactly as large as your potential-customer community. Get them involved!

Jack Repenning

Jack Repenning is Chief Technology Officer at CollabNet. Jack joined CollabNet in 2002; as chief product architect he was primarily responsible for building the product architecture that enabled CollabNet to grow its user base to well over one million users. Jack is also an early member of the wildly successful Subversion open source project, a version control system that is widely viewed as the de facto new industry standard. Consistently engaged in developer productivity topics, Jack has participated in open source software projects since the early 1980’s. Prior to joining CollabNet, Jack worked at well-known Silicon Valley companies such as Hewlett Packard, SGI, Informix, and Rational where he developed expertise in a wide range of technical areas, ranging from inside the kernel to GUI and database design, as well as data center deployment architecture. Jack holds degrees in Electrical Engineering and Information and Computer Science from the University of California, Irvine.

Twitter - More Posts

  • http://profile.typepad.com/1216419899s29006 Guy Martin

    Fabulous stuff Jack! I know that there has been a movement afoot to try and do this with textbooks as well (College down to the grade-school level). Unfortunately, at least in CA, the government red tape on what constitutes ‘acceptable’ textbooks has made this an uphill battle. :( However, I’d love to see success like O’Reilly rub off in this area – not only because of the great diversity of content is valuable, but because I’d like to see the cost of textbooks go down and the quality go up!

blog comments powered by Disqus