When Iβm first learning about some new thing, X, I get a lot more value in someone I know saying "I like X" or "I dislike X" or "Iβm interested in X" or "I something X" than a detailed objective description of what X is.
@neil For me, use-cases, examples, and pitfalls are most useful.
I want to see what it is X can do, and what you want to be concerned with.
UNIX Power Tools is an exemplar of this in the Unix / Linux documentation case.
@neil "the cool thing about X" or even "the bad thing about X"
@vera Precisely! That's a massive value of the agora to me, an easy to find bunch of opinionated writing on a topic by people you already know.
Hmm I might rephrase - 'when I'm first deciding whether to learn about X'...