top of page
All Posts


Amalgamation part 1 - Your Documentation Doesn’t Need to Be Perfect—It Needs to Be Modular.
One of the biggest blockers to keeping documentation (and AI responses) current is the myth of the rewrite. You don’t need to overhaul the whole help center. You just need to update the one thing that changed. Every release cycle, I see it: A new feature launches Release notes get drafted But the linked help doc… isn’t touched And the AI agent? Still trained on last month’s truth What if you treated each help article as its own data asset? Change a feature, update one doc, an

Hal Warfield
6 hours ago1 min read


AI Lessons the Hard Way (and why it was worth it)
Like a lot of people who've been using generative AI seriously, I found it both genuinely useful and genuinely maddening. The frustrations are familiar if you've been there: running out of conversation space mid-project. Watching a long working session get progressively more confused as it tried to hold too many threads. Starting a new chat and realizing the AI had no memory of the three weeks of context I'd worked on. For something marketed as a collaborator, it had a remark

Hal Warfield
2 days ago3 min read


One Journey, Five Channels
Amalgamation - originally came from Latin meaning to mix mercury with another metal. Later it became a word meaning combining different things into one. What does that have to do with product documentation? Because in most tech companies, help and documentation consists of a number of different systems that don’t mix. Eye-level view of a tech workspace with a laptop and notes Amalgamation - originally came from Latin meaning to mix mercury with another metal. Later it beca

Hal Warfield
2 days ago5 min read


Amalgamation · Part 2 — Same Question, Five Answers
A fast way to measure trust in your help system is brutally simple: take one common question and count how many versions of the answer exist across your surfaces. If you get five, you don’t have “coverage”; you have confusion. Customers hesitate. Your AI bot tries to average contradictions. Teams fix one copy and miss the others. The result is slower time-to-value and preventable tickets. This pattern usually appears for good reasons. Support writes an FAQ to stop an escalat

Hal Warfield
2 days ago3 min read
bottom of page