Re:WTFM - Write The Freaking Manual
by tsahyt on Friday September 28, 2012 @08:57AM
(#4585243)
Yes, this. I'm looking at you, freedesktop.org... PulseAudio documentation is poor. Considering it doesn't really work out of the box on half the systems out there that's pretty bad. fontconfig docs are some of the worst I've seen in a long time. In general, I feel dizzy when I find a link with "freedesktop.org" in it labeled "docs"...
There are plenty of other examples. Seriously, documentation is extremely important. Especially if you're relying on config files, document them properly.
There are plenty of other examples. Seriously, documentation is extremely important. Especially if you're relying on config files, document them properly.