For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL.

Search results

Updates to my coffee, car-buying, and zero-drop shoe posts, plus my Jekyll documentation theme

by Tom Johnson on Nov 8, 2026
categories: writing

I don't often update previous posts, but I recently updated four things I really wanted to revisit. I went back to drinking coffee, returned the Honda Civic from my car-buying post, stopped recommending zero-drop shoes for calf strains, and released a new version of my documentation theme for Jekyll, which now looks more like idratherbewriting.com.

Here are the 4 posts I updated and why:

  • Too much coffee?: In April, I wrote about quitting coffee after hitting a point where caffeine no longer seemed to help. About six months later, I went back to drinking coffee, and the update section explains why.
  • Buying a car in the age of AI: This September post ended with me buying a 2019 Honda Civic. I ended up returning the Civic and buying a 2026 Subaru Forester Hybrid instead. The update section covers how and why.
  • Barefoot shoes, basketball, and how to avoid recurring calf strains: I added a note at the top of this 2021 post saying that I no longer recommend zero-drop shoes and why.
  • Documentation theme for Jekyll: Release 8.0 redesigns the theme on Bootstrap 5 so that it looks more like idratherbewriting.com. I know Jekyll is no longer the static site generator of choice, but it continues to work well for me, and its integration with GitHub simplifies continuous publishing for a blog.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, agent skills, tech comm careers, and more. Check out my AI courses for more on the latest in AI and tech comm. If you're looking for info about documenting APIs, see my API documentation course.

If you're a technical writer and want to keep on top of the latest trends in tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me.

Finally, I want to note a couple of things. I usually write the first drafts of my posts myself and then use AI to improve accuracy, clarity, and detail in places, so my writing is a mix of human and AI. (Hopefully that's not too off-putting.) Also, the opinions I express on my blog are my own perspectives, not those of my employer.