I'll be at @poplconf 2020! Do say hello.
miniblog.
Related Posts
It's so hard to talk about probabilities. Casual conversation often conflates 'the likelihood of an event happening' with 'how strongly I believe in my assessment'.
For example, I'm very confident (say 90%) that the coin in my pocket is 50% likely to land on heads.
There are docs resources like https://diataxis.fr/ that categorise documents based on format and intended audience.
They don't say where you should start, or what order you should write docs.
I'm currently thinking README > reference > tutorial > how-tos. Agree/disagree?
I hear people say that Go is often hard to search online (hence sometimes "Golang"), but the vast majority of language names are common words. Names with punctuation (C++, C#) are hard too.
Is this a big problem in practice? "Perl" isn't a dictionary word, but it's an exception.