[iDC] mining open source
Andreas Schiffler
aschiffler at ferzkopp.net
Tue Mar 7 10:31:09 EST 2006
adam wrote:
> I think it would be interesting to turn some of the energy spent on FLOSS evangelism into energy for creating good professional documentation on free tools.
>
Just wanted to mention that, as a FLOSS developer myself, I rarely - if
ever - spend any time on evangelism.
The state of documentation for open source stuff comes very simply from
the fact that its work to create good documentation - and its unpaid
work. For example my SDL_gfx package that is part of many Linux distros
now, was really developed while working on commercial stuff. I needed
some functions, wrote the code, then published it. Of course it has
basic documentation in form of a README.txt and webpage (which is the
README.txt wrapped in <pre> tags). But other than that, I don't feel
like making a nice PDF for it ... nor do any of the other thousands of
people who use the library. In the 4 years of the libraries public
existence, I've gotten 2 smallish additions as source code contributions
and a few bug-reports. No documentation or nicely done manuals were ever
requested or submitted.
Go and ask yourself this question: Which OSS tool are you using right
now and find inadequately documented (or at least lacking in examples
and training material). Would you spend 1-2 week of your time to
research and write documentation, then get it published? And then commit
to1 day a month for maintaining it for the next few years? And then face
an interface or API change which makes your documentation partially
obsolete?
Many projects these days adopt a Wiki structure for documentation - a
maintainers time-saver, since many people can contribute in parallel and
its fully searchable. But its not a printed manual. (Example:
http://www.masonhq.com)
In my view, a well funded "bounty hunt" model would work great. See an
example for the Gnome desktop project that is funded by Novell:
http://www.gnome.org/bounties/
So the question is: Why do Institutions have no "bounty hunt" budgets
for their OSS use and deployments?
-------------- next part --------------
A non-text attachment was scrubbed...
Name: aschiffler.vcf
Type: text/x-vcard
Size: 135 bytes
Desc: not available
Url : http://mailman.thing.net/pipermail/idc/attachments/20060307/b30948fc/aschiffler-0002.vcf
More information about the iDC
mailing list