Software, Digital Content, Geopolitics, Economics & More from of a Libertarian Serial Expat and Entrepreneur
In: software28 Jun 2007
David Erickson posted an entry I meant to write for years. Open source is great at a lot of things, but let’s face it, documentation is often incredibly lousy. I’m spending a lot of times these days looking at what we can and can’t do with our PHP/Wordpress/OpenAds toolset. Sometimes it really feels like a root canal to get answers to seemingly simple questions. MSDN is far from perfect, but it’s heaven compared to, say, how variable scoping is defined on the php.net site, empty pages in the WordPress codex, or confusing PAN/MMM roadmaps (though OpenAds is at last starting to clean its house on that front).
For-profit companies built around open source projects need to understand this is a critical missing piece. Unlike David, I don’t have high hopes that users are suddenly going to turn into good documentation writers. This is a tedious, time-consuming job and you need to keep the content updated. It has to be funded because it won’t work as a labor of love. Yes, you can buy O’Reilly books, but I don’t think the book market alone solves it.
(Sorry, my comments are broken and won’t be fixed for a while, please comment on your own blogs!)
Somewhat related from the archives: Open Companies More Important than Open Source.
02/02/08 update: Bottom line, all weblog apps suck in some way.
I'm CEO of an online trade publishing firm in the marketing and defense verticals. We try to make news and data digestible and useful in an environment that is more noisy each day. This personal blog mixes my thoughts and interests on politics, business, software, and more, based on my business and personal experiences. Over the years I have posted items that turned out spectacularly wrong, and a few posts that stood the test of times better. Personal views only.