Why I Started Doc4Docs
After 25 years in IT, I still see the same problem everywhere: products that deserve better documentation than they have.
Doc4Docs
Every product deserves great documentation.
Latest posts
Documentation as a Competitive Advantage
When two products are roughly equal, documentation often decides which one wins.
AI Tools for Technical Writers: What Actually Helps
AI can help with documentation. It can't replace the person who understands the product and the user.
Documentation Isn't Only for Software
Every product that has users has a documentation problem. Software just makes it more visible.
Minimum Viable Documentation
You don't need perfect documentation. You need enough documentation that users can succeed.
How Open Source Projects Handle Documentation
Open source documentation ranges from exceptional to nonexistent. The difference is almost never about talent.
UX Writing and Documentation: Where They Overlap
UX writing and technical writing serve different moments in a user's journey. Understanding the difference makes both better.
Your Changelog Is Also Documentation
A changelog is not a formality. It's documentation for the people who already use your product.
The Problem with PDF Documentation
PDF documentation feels professional. It's also often the worst format for the people who need the information.
Docs-as-Code: Why Your Documentation Should Live Next to Your Code
Treating documentation like code — with Git, pull requests, and CI/CD — changes how teams relate to it.
How to Write a Good README
The README is the front door of your project. Most of them are locked.
Technical Writing and Developer Advocacy: What's the Difference?
Both roles care about documentation. They approach it from different directions.
Every Page Is Page One
Mark Baker's concept changed how I think about structuring documentation. Nobody starts at the beginning anymore.
API Documentation Done Right
API documentation has its own rules. Here's what separates the docs developers actually use from the ones they ignore.
What Write the Docs Taught Me About Documentation
Write the Docs is a conference and a community. After speaking there, here's what stayed with me.
Documentation Is a Product Feature
Documentation is not the thing you do after shipping. It's part of what you ship.
Why Developers Hate Writing Docs (And What to Do About It)
It's not laziness. The reasons developers avoid documentation are structural, cultural, and sometimes entirely reasonable.
The Diataxis Framework: Four Types of Documentation
Daniele Procida's Diataxis framework gives documentation a clear map. Here's what the four types are and why the distinction matters.
The Real Cost of Bad Documentation
Bad documentation has a price. It shows up in support tickets, lost users, and products that never reach their potential.
Documentation Is Not Dead in the AI Era
Every few years someone declares documentation dead. AI is the latest reason. They're wrong, and here's why.