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

[-] Sibbo@sopuli.xyz 73 points 3 weeks ago

The documentation:

Put the leaves inside the cup

[-] christopher@lemmy.ca 52 points 3 weeks ago

Then the user rips open the bag and pours the leaves inside

[-] spankmonkey@lemmy.world 12 points 3 weeks ago

Yes, that could be a third option.

[-] rbn@sopuli.xyz 8 points 3 weeks ago

And pours the boiling water on its legs.

[-] toynbee@lemmy.world 3 points 3 weeks ago

If a highly improbable spaceship had to dedicate all of its processing power to making a cup of tea, I suppose I can forgive an end user for having to think about it.

[-] SourGumGum@lemmy.world 1 points 3 weeks ago

Tea, earl grey.

[-] toynbee@lemmy.world 1 points 3 weeks ago

But what temperature?!

FWIW, my reference was to H2G2 and the Heart of Gold.

[-] dosuser123456@lemmy.sdf.org 2 points 2 weeks ago

H O T .

[-] bdonvr@thelemmy.club 2 points 3 weeks ago

I mean that's a valid way of tea drinking.

[-] 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.