When will Reference manuals really be usable?
I write code and manuals for 36 years and I've learned that those are too often written by a person who fails to put himself in the readers position. A reader who's not familiar with the topic otherwise the material was not required in the first plac...