How to complain
Try to avoid writing things like this
Foo is bad, and bar is better; here is why ...
Or, at least, be very careful about writing such things.
Why? Because inevitably, somebody will respond: ‘wait, I was confused, but I think I’ve figured it out: what you’re calling a “bar” I know as a “frobnicated foo”’.
A frobnicated foo is obviously a type of foo. So writing things like that alienates a core part of your audience: the people who have strong opinions on frobnicated foos and thing they’re great. That is, the people who agree with you. But they will be put off when they read that foos are bad, and it will be difficult to win them back.
Try to write things like this instead
Often, when people try to solve a problem, they employ a particular approach. This approach is prone to problems; here is why an alternate approach does not run into those problems.
Names are difficult, and people frequently disagree on their meanings. Replace pesky names with descriptions.
And absolute statements (‘foo is always better than bar’) are quite strong, and require an equally strong defense. It’s not necessary to explicitly state an absolute, even if you think it holds. ‘It might be better to use bar than foo sometimes’ is easier to defend than ‘bar is better than foo’, and it’s usually more true.
... continue reading