Effective writing for software developers
Visit refactoringenglish.com → RSS feedOn Hacker News Jan 2025 – Oct 2026
Life, Learning & Writing 6Software Engineering 5Tech Industry & Business 2Career & Management 1
Software bloggers can make the same mistakes for years that prevent readers from discovering their writing. I know because I'm one of them. Over time, I've learned techniques that help some blog posts succeed and the pitfalls that cause others to languish in obscurity.
It's easier than you think to write an exceptional software tutorial. You can stand out in a sea of mediocre guides by following a few simple rules.
Best practices for writing a design doc based on my experience working as a developer at Google and Microsoft.
Effective writing for software developers
I started reading software blogs before I got my first programming job 20 years ago. At this point, I've read thousands of blog posts and essays, but a small handful stuck in my mind and changed the way I think about software.