3 ms·
Close pet peeve of mine is "simply" in documentation. Aside from emotional aspects in OP, there is (not-so-well) hidden complexity, implicit assumptions, and/o
by baobun 1y ago
Close pet peeve of mine is "simply" in documentation.
Aside from emotional aspects in OP, there is (not-so-well) hidden complexity, implicit assumptions, and/or non-intuitive implications papered over almost every time I see it.
"In CrabFramework, a StateCrab is simply a Crab which carries state."
"In order to garbage collect a Nest, you simply apply the GC op: Nest.applyOp(nest, Nest.GC, { tuningParams: Nest.StandardGCTuning }). That's all there is to it!"
One does not just simply.