4 ms·
There are plenty of ways they can have humor that don’t compromise technical docs. You want to know how to ease the load of maintaining open source? Make onboa
by SilasX 4y ago
There are plenty of ways they can have humor that don’t compromise technical docs.
You want to know how to ease the load of maintaining open source? Make onboarding easier. That means good, clear docs that aren’t cluttered with cryptic inside jokes.
Seriously, the way they work, you’d almost think they don’t want people to get involved. (In Mozilla’s case, probably because they blew their budget on the latest resume builder.)
It would be one thing if I were asking for a special feature of the product. Here, I’m asking for something that saves your support staff from being pestered by people that couldn’t understand the cryptic docs. Why wouldn’t you want that? [1] Why wouldn’t you be thanking anyone who suggests ways to save you time?
Sometimes I wonder if noticing this kind of stuff is a superpower, because it’s in really short supply.
[1] Maybe because you moonlight as an Optimism maintainer: https://news.ycombinator.com/item?id=30294065 https://news.ycombinator.com/item?id=30294065