blog! “Can you follow your own getting started guide?”
I was trying to install a new open source project and was having a hell of a time. Nothing seemed to be working despite me following the tutorial to the letter. I was getting the most bizarre error messages and was on the verge of quitting to become a goat farmer, when I threw one […]
⸻
#documentation #OpenSource
@Edent I'm reading "The Design of Everyday Things" by Donald Norman right now, he points out that people very often think it is their fault that they don't understand how something works (spoiler alert: it's not - it's bad design or communication). So that may be a reason why the tutorial had been wrong for a few years. I work with many "non-technical" people - they simply give up in these cases.
@izabelamisiak
Love that book! I reference it all the time.
https://shkspr.mobi/blog/?s=design+of+everyday+things
Amazing how relevant it still is.
@Edent It's fantastic! And very relevant. I love the design perspective for (probably) all things and topics, it's so helpful.