I find quite a large number of what should be very good and high quality open source projects that are just utterly and completely useless do to shitty, out of date, or non-existent documentation.
Just a rant. A side note.
Just a reminder to myself a others.. the quality of your documentation is more important then the quality of your code.
Posted Jul 17, 2009 10:35 UTC (Fri) by nix (subscriber, #2304)
[Link]
Oh, there's nothing wrong with socat's documentation. It's just that if you print the manpage out it's 40 pages long. It has *so many* options that trying to find the one you want is quite painful, even though they're all fairly regular. The options had to be classified along multiple dimensions to make sense of them...
(I picked Emacs for a reason: it too has excellent documentation and is huge.)