1166

The general feeling of documentating things (lemmy.world)

submitted 3 weeks ago by merari42@lemmy.world to c/programmer_humor@programming.dev

51 comments fedilink hide all child comments

you are viewing a single comment's thread
view the rest of the comments

[-] Aceticon@lemmy.dbzer0.com 7 points 3 weeks ago* (last edited 3 weeks ago)

All lot of it is, without exageration, more at the

Put the proper side inside the cup

level of clarity: in other words just moving the "everybody should know this" element around rather than concretely just coming out and clarifying the bit that in the programmer's mind is "obvious".

[-] CanadaPlus@lemmy.sdf.org 4 points 3 weeks ago* (last edited 3 weeks ago)

If you're specialised enough it can be really hard to tell what's obvious. Like, you don't want to do "grab the mouse, which is one of your computer peripherals" either. Or at least, I worry about doing something like that, and coming across as a dick.

Relevant XKCD.