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”.
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.
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.
The documentation:
All lot of it is, without exageration, more at the
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”.
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.
It does say “leaves” and not “bag”
Then the user rips open the bag and pours the leaves inside
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.
Tea, earl grey.
Yes, that could be a third option.
And pours the boiling water on its legs.
I mean that’s a valid way of tea drinking.