Blog

My blog. Personal thoughts, anecdotes, and musings.

Return to Structured Content Published April 8, 2025

My biggest frustration with modern docs is that much of the industry standardized on Markdown. And Markdown isn’t semantic. A keyword, a term, a “first use” item all don’t exist. You mix presentation with meaning rather than separating. XML for docs wasn’t fun but it was structured. You could denote terms. You could have actual admonitions. And so the solution seems to be hacks that turn Markdown k to structured docs, embedded HTML spans with classes, and….


Job Hunting in the AI Age Published April 7, 2025

Networking and referrals land you jobs because AI is screening you out of the application pile.


New Book Published March 8, 2025

I started writing a new book. It’ll be short. But it’ll be hands-on. I’m writing it because this is the third time I’m implementing the topic, and I’m tired of writing the same explanations. I want a book to point at. I’m no stranger to this. There are docs for lots of things, but reference docs only tell a part of the story. People need a golden path. And I’m good at providing that.


You Own It Published December 9, 2024

I keep seeing how “LLMs are great teaching tools! I asked it to explain X to me and it did!” Don’t be fooled! Ask it to explain a technical topic you deeply understand and you’ll start to see where it makes things up. It is a predictive text engine. Sure, you can do all sorts of prompt hacking to get better results. But at the end of the day, if you don’t know the topic really well you will never know if it made up the facts it gave you.


Solving Problems with Code Published May 25, 2024

Software development doesn’t have to be your career. Use it to solve pain points in your life, like the one I had today.


Wrapping Up the Year Published December 21, 2023

I started out the year thinking it would be “business as usual.” Boy was I wrong.


One Year at Temporal Published March 21, 2023

I’ve been at Temporal for a full year. So, how’d it go?


Learning Styles are a Myth Published December 15, 2022

You may have heard of learning styles. But it turns out there’s no evidence to support them.


Moving On from DigitalOcean Published March 15, 2022

A look back on my time at DigitalOcean as I close the books on nearly six years at this great company.