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.