> Similarly, when documentation mentions to "simply" do something, and I don't get it, isn't that a clear hint that I'm still missing a concept somewhere and ne

> Similarly, when documentation mentions to "simply" do something, and I don't get it, isn't that a clear hint that I'm still missing a concept somewhere and need to look around for an explanation? Nah, it's fluff. Write good technical documentation, not your wishy-washy feelings about how easy or hard it is. edit: write like you'd write an RFC. > Or maybe -- controversial opinion here -- people shouldn't be such babies. Seriously, why is the introduction of the top comment a thinly veiled insult disguised as a weak rhetorical device ?