upvote
Nice to see some Butterick fonts employed on a blog. ;) Mine’s the same, but I went with Valkyrie and Hermes Maia.
reply
I actually don’t like when technical blogging/writing is too casual, that’s distracting to me, the author isn’t my pal. It shouldn’t be excessively formal (as you’ve titled it) either, but neutral and matter-of-fact. For example, I enjoy Dijkstra’s writing style.
reply
Yeah, I think a cool thing about blogging is that there are so many distinct tastes that there's a lot of room for different writing styles, and you can find people who like your style.

When bloggers say, "I don't want to write about topic X because person Y already wrote the definitive post about it," I say, "However good the existing article is, there will still be people that prefer yours." Even if the other person is smarter, more knowledgeable, whatever, you're going to explain it in your own way, and that's going to resonate with a distinct set of people than any other article out there.

reply
I think the biggest anti-pattern is not writing for who you are targeting, your intended audience.

I think your anti-patterns apply very well to the stereotypical SWE or HN reader, and if that is who you are targeting, you should absolutely follow these. But the biggest anti-pattern of all is following these anti-patterns while hoping to appeal to the untypical SWE or HN reader.

reply
Thanks for reading!

> I think your anti-patterns apply very well to the stereotypical SWE or HN reader, and if that is who you are targeting, you should absolutely follow these. But the biggest anti-pattern of all is following these anti-patterns while hoping to appeal to the untypical SWE or HN reader.

Can you share more about what you have in mind?

I feel like these recommendations apply outside of software/HN. Like if I had a way to reach knitting bloggers, I'd imagine most of the concepts would be the same with different specifics.

Do you have a software blogger in mind that writes well but doesn't match what I describe in the post?

reply
I fall into the camp where I agree with these antipatterns, so I'm probably not the target audience for the question. But a scenario could be if I was writing to appeal to PhDs or researchers, maybe I should include the links or citations on top of providing a brief summary of what a firewall is. Firewall might be a simpler example, but let's say a semi-novel algorithm for research sake.

My thinking there is PhDs/researchers a lot of the time like to dig deeper and are also pretty skeptical of new information and want to see it backed up by someone else unless the claims are completely novel, then they want the raw evidence typically in line or near what was stated as novel.

reply
Friday will be the 20th anniversary of my first blog post, and I will continue to write sequels to my previous blog posts, and you can't stop me! ;-)
reply