Refactoring English
refactoringenglish.com · Personal blog · on HN since 2024
Writing advice for software developers, covering blog posts, design documents, commit messages, tutorials, and emails, plus a ranking of popular HN personal blogs.
What HN saysHN links it for its writing rules, such as for tutorials, and its ranking of top personal blogs on HN.
31HN people shared it
16linked it in comments
41stories submitted
2.0Kstory points
3 months agolast shared
2024people per year2026
Most-shared posts
- 1The highest-ranking personal blogs of Hacker News8 people · 508 points · first shared 2025 · 128 comments on HN
- 2How to write blog posts that developers read4 people · 611 points · first shared 2025 · 154 comments on HN
- 3How to Write an Effective Software Design Document4 people · 12 points · first shared 2026 · 6 comments on HN
- 4How to Write Useful Commit Messages3 people · 13 points · first shared 2025 · 2 comments on HN
- 5Refactoring English: Effective Writing for Software Developers3 people · 5 points · first shared 2024 · discussion on HN
- 6Rules for writing software tutorials2 people · 376 points · first shared 2025 · 74 comments on HN
- 7Software essays that shaped me2 people · 336 points · first shared 2025 · 47 comments on HN
- 8Underused Techniques for Effective Emails · Refactoring English2 people · 22 points · first shared 2025 · 2 comments on HN
- 9The Most Popular Blogs of Hacker News in 20252 people · 11 points · first shared 2026 · discussion on HN
- 10What Makes the Intro to Crafting Interpreters So Good?2 people · 8 points · first shared 2025 · discussion on HN
- 11I Stopped "Creating Content"2 people · 2 points · first shared 2026 · 1 comments on HN
- 12Hn popularity2 people · first shared 2026
- 13Methodology2 people · first shared 2025
- 14How to Write Compelling Release Announcements1 people · 70 points · first shared 2025 · 49 comments on HN
- 15How to Get Meaningful Feedback on Your Design Document1 people · 4 points · first shared 2025 · 1 comments on HN
What HN people wrote when they linked it
mtlynch · 2024-11-14
Re-posting from a similar answer I gave in another thread:
Yep, still happy with the decision. A lot of my comp at Google was stock, so I would have made a lot from the stock price movement over the last six years, and I'm a bit envious of that, but still yes.
I do still love the independence of working for myself, so I'm happy to have had the last six years of that rather than feeling unfulfilled at Google.
With everything shifting around AI, and big tech could be doing massive dev layoffs in the next five years. Given that risk, I'm happy to have experience as a founder rather than a dev who could be laid off immediately in a down market.
https://news.ycombinator.com/item?id=42126800
>Do you feel richer or poorer for the experience?
Definitely richer. I'm glad I did it, and it was so much more meaningful than the work I did at Google or any previous job.
>What's next for you?
My wife and I just had our first child over the summer, so I'm mostly on paternity leave to enjoy time with my family, but I'm slowly easing back into work. My next project is a book about what I've learned about writing effectively as a software developer.[0] Eventually, I'd like to try building a SaaS, but working on a book is much friendlier to an unpredictable work schedule at the moment.
[0] https://refactoringenglish.com/
dynm · 2025-03-28
I reckon if you wanted to choose just a single rule it should be, "Write something that you yourself would actually read." The problem is that our brains are designed to sort of lie to us and tell us that what we've created is amazing when in fact we'd never actually read it if someone else had written it. If you can find a way to be objective and see your own writing as the far-from-perfect mess it actually is.
(In principle, you could use "write something that someone else would actually read", but I think this is much harder, because it's much harder to know how other people would react! If you yourself would read it, well, we aren't that unique, lots of other people would read it too.)
Also, props for this stark picture of reality: https://refactoringenglish.com/chapters/write-blog-posts-developers-re…
kmoser · 2025-01-03
https://refactoringenglish.com/chapters/rules-for-software-tutorials/#…
Sometimes this advice of describing what something is and why you'd use it is helpful. Other times I already know what it's for and just want to use it, and don't like having to slog through descriptions that don't help with implementation. There is no universal right or wrong answer here, since it will depend on who is reading your tutorial, what their level of expertise is, and what they need.
A tutorial can provide the best of both worlds by putting the background stuff of each section in a sidebar, so the reader can easily skip it or delve more deeply if they wish.
RunSet · 2026-07-21
> In 2026, compute is becoming the spice of our era.
I think it more resembles the "content" of our era.
https://refactoringenglish.com/blog/why-i-stopped-creating-content/
firefoxd · 2026-01-14
My website: https://idiallo.com
It made it to #9 of the top 100 personal websites on HN for 2025. https://refactoringenglish.com/tools/hn-popularity/?start=2025-01-01&a…
susam · 2026-01-03
He is featured in the top 100 list. See here: https://refactoringenglish.com/tools/hn-popularity/?start=2025-01-01&a…
simonw · 2026-01-03
The methodology is explained here: https://refactoringenglish.com/tools/hn-popularity/methodology/
You won't show up unless your site is listed in this manually curated CSV file: https://github.com/mtlynch/hn-popularity-contest-data/blob/master/data…
spidersenses · 2025-09-03
Check out this list:
https://refactoringenglish.com/tools/hn-popularity/
Perhaps the blog that you're looking for is among the most frequently posted blogs on HN.
Anything else you can remember about the design or subject matter? In which programming language were the code snippets?
arjunlol · 2025-05-21
This blog post could be helpful https://refactoringenglish.com/chapters/write-blog-posts-developers-re…
mmphosis · 2025-04-23
I recently found: The highest-ranking personal blogs of Hacker News
https://refactoringenglish.com/tools/hn-popularity/
nuredini · 2025-03-29
It's interesting to see how some of the most popular blogs in https://refactoringenglish.com/tools/hn-popularity do the opposite of what's being suggested here.
Still, for most people who are still finding their style and (for some reason) are optimizing for popularity, this seems like sound advice.
shric · 2025-03-26
You're well into https://refactoringenglish.com/tools/hn-popularity/ so enjoy the fame!
philipkd · 2025-03-28
I'm a fan of both HN and DF. If I assume my worldview is accurate, that both are above-board, then the only explanation I have left is flamewar detection. Your links get too many comments—plus some flags sprinkled in there—too fast relative to upvotes. So, your posts get too much engagement.
There is a twisted logic to that algo, esp. for a "News For Nerds. Stuff That Matters"-flavored attitude, and esp. for a site that's trying to be as efficiently managed as possible.
Plus, Scott Alexander noted recently a decline in Substack due to deboosting on X, but also that just too many people are now Substacking, many of whom are good, and a lot who are just clones. And on the Dithering about "Rotten", you and Ben both concur that it feels like a while since either of you went viral. So as soon as a solo blogger blows up, the system quickly co-opts that blend of content into other media channels. i.e., Indie generally doesn't last.
I did a YoY look at your rankings:
2007: #50
2008: #20
2009: #3
2010: #1
2011: #2
2012: #7
2013: #34
2014: #17
2015: #568
2016: #184
2017: #8
2018: #69
2019: #86
2020: #8
2021: #20
2022: #406
2023: #98
2024: #133
2025: #53
(10/9/20XX – 10/09/20XX)
https://refactoringenglish.com/tools/hn-popularity/?start=2006-10-09&a…
Something weird definitely happened in 2015/2016, for sure (maybe the start of the anti-engagement algo). But your blog was also crazy popular between the iPhone's release and Steve Jobs' death. That was…
tmvnty · 2025-11-28
There are indeed many ways of consuming HN/news. Here are just few ways I've collected recently:
- https://hckrnews.com/
- https://hcker.news/
- https://hn.unlurker.com/
- https://refactoringenglish.com/tools/hn-popularity/
- https://lessnews.dev/
- https://news.kagi.com/world/latest
- https://forty.news/
- https://news.ysimulator.run/news
e_ · 2025-03-27
I am not sure to be honest, hence “apparently”. It also might be the case that this is less important than the other points I mentioned.
I’m also not sure you could say you were “consistently” at #3 from 2007 to 2021. That would be like saying you were “consistently” at #5 from 2007 to 2025.
Let’s check other periods:
From 2020 to 2021, you are ranked #13 [1].
From 2018 to 2019, you are ranked #26 [2].
From 2017 to 2018, you are ranked #15 [3].
From 2015 to 2016, you are ranked #179 [4].
From 2014 to 2015, you are ranked #33 [5].
[1]: https://refactoringenglish.com/tools/hn-popularity/?start=2020-01-01&a…
[2]: https://refactoringenglish.com/tools/hn-popularity/?start=2018-01-01&a…
[3]: https://refactoringenglish.com/tools/hn-popularity/?start=2017-01-01&a…
[4]: https://refactoringenglish.com/tools/hn-popularity/?start=2015-01-01&a…
[5]: https://refactoringenglish.com/tools/hn-popularity/?start=2014-01-01&a…