News for hackers. Stuff that matters.
Re:Strftime's alpha-sorted man page vs. well-meaning people by kazinator on Sunday May 13, 2018 @05:37PM (#17061176)
No interface redesign or documentation improvement will prevent all "brain-o" situations. Which is what happened to Rachel here. Nothing wrong with the document; but sometimes you stare at something completely simple (be it code and documentation) and somehow misunderstand it. Later you go back and can't figure out how you got tripped up. It's impossible to predict where this will happen to whom.

Blaming the order of the documentation is grasping at straws.

"This thing that tripped me up for an inexplicable reason wouldn't have done that if the documentation for the thing I wanted to use had appeared first in the document".

There are no comments on this comment yet.