Comment Re:The best documentation is the source (Score 1) 299
My brain is not a turing machine, and I don't have
I'm not going to read the source code to sox to learn how to resample a wav file for an audio book I want to listen to. I am not a contributor to the sox program, and have no desire to dig through the source code. Fortunately, the docs are pretty good, and I found out how to do that in a few minutes.
I'm not going to read the source code to perl to learn the arguments for the sort function. It took me thirty seconds to find that out the other day, most of which was me walking over to my bookshelf to get my copy of Programming Perl.
I'm sure as hell not going to read the source code to Windows to turn off the annoying startup noise it makes even when you choose "no sounds" as your sound profile, since even if I was so masochistic to try it isn't available anyway. I blundered about and figured that out on my own, since I have no faith in the Microsoft help system (I don't use Windows enough to know where stuff is anymore, but boot it every now and again to run a program I can't run with Wine).
If you need to read the source code to figure out how to use a program, then that program is useless to 99.9% of computer users. Yes, it will tell you exactly what the program does, but in the real world your documentation needs to be more accessible.