News for hackers. Stuff that matters.
Re:Examples Are the Best Documentation by constant_flux on Friday October 10, 2025 @12:20PM (#45540652)
Did you stop to consider that perhaps other people learn differently than you, and find examples as a way to soften the friction that context switching causes in a job?

I don't understand the resistance to examples being a part of documentation (and not a bonus).

Re:Examples Are the Best Documentation by shemtay on Friday October 10, 2025 @12:35PM (#45540812)
sometimes professionals need to fix shit and need exacting clarity
Re:Examples Are the Best Documentation by joemi on Friday October 10, 2025 @05:58PM (#45544267)
It shouldn't be an either/or situation. Good documentation should include both the API spec _and_ examples. I believe the person you're replying to was complaining about documentation that's _only_ examples since it seems like that's what TFA was advocating for.
Re:Examples Are the Best Documentation by KalMann on Friday October 10, 2025 @06:57PM (#45544777)
I think you're being unfair. The blog post claimed "Examples are the best documentation". If I use your own logic, shouldn't I say to the blog writer "Haven't you ever thought people learn differently from you?".

I think harimau777 was just expressing his opinion, like the blog owner.