Re:Strftime's alpha-sorted man page vs. well-meaning people
by rachelbythebay on Sunday May 13, 2018 @08:46PM
(#17061898)
It was never about me. I didn’t make this error. I did, however, fix it and added steps to make it not happen again.
"I can't explain why I didn't understand this simple, clear piece of documentation. But, aha, if the sections weren't sorted such that it came first before the common thing I was looking for, this wouldn't have happened."
It's just grasping at straws.
There is no way for a documentation writer to predict who will have a momentary brain lapse, reading what passage.
Putting something more toward the back of the document isn't a guarantee that someone won't trip up on it.