Re:Strftime's alpha-sorted man page vs. well-meaning people
by kazinator on Sunday May 13, 2018 @05:45PM
(#17061208)
I don't think Rachel is incompetent. She had a brain-slip and is trying to blame it on some external factors.
"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.
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.
> %G The ISO 8601 week-based year (see NOTES) with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %Y, except that if the ISO week number belongs to the previous or next year, that year is used instead. (TZ)
I think that's pretty clear, so its actually just a case of not reading / bothering to understand the documentation. I think if you really want to bulletproof a system against incompetency we should probably not start with C.