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.
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.
The documentation:
Then the user rips open the bag and pours the leaves inside
Yes, that could be a third option.
And pours the boiling water on its legs.
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.
But what temperature?!
FWIW, my reference was to H2G2 and the Heart of Gold.
I mean that’s a valid way of tea drinking.
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”.
A lot of it is just “put it in”
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”