Michael Lynch

https://refactoringenglish.com/blog

3 posts · 47 Votes · 1 Followers

Tech

Subscribe via RSS

  1. Anti-Patterns in Software Blogging

    In software development, we collect anti-patterns to recognize common traits that lead to poor outcomes in our software. I thought it would be helpful to do the same for software blogging, so I’ve catalogued the most frequent mistakes I see from beginner bloggers. The meandering intro Preamble still counts as meandering “The reader knows everything I know except this one thing” Overreliance on links The sequel injection bug Excessive formality Fumbling on the basics of rendering HTML Page…

    0 ▲
  2. Why I Stopped "Creating Content"

    The first time I saw Michelangelo’s David in person, I wept. Never in my life have I witnessed a more beautiful piece of content. I wasn’t the only one who felt that way. Museum patrons all around me were looking up from their phones to admire David as well. Despite it being legacy content, David was so scrollstoppingly captivating that it generated stronger engagement than TikTok and Instagram combined, despite those platforms offering fresher, more personally relevant content.

    47 ▲
  3. Which Design Doc Did a Human Write?

    I created three design docs for the same open-source web app: I spent 16 hours writing one of the design docs completely by hand. I generated one using Claude Opus 4.6 (medium effort). I generated one using GPT-5.4 (high effort). I generated the AI versions in a few minutes. I fed the agents a prompt that included the design docs chapter of my book and a skeleton design doc structure. The agents who wrote the AI-generated docs did not see the version I wrote.

    0 ▲