Documentation
How to keep docs accurate as code changes: drift detection, freshness checks, and the case for writing things down.12 posts
A stale AGENTS.md is worse than no AGENTS.md
Cloudflare built an internal platform to keep AGENTS.md files fresh across thousands of repos. Here are the methods to keep yours current, and how we do it at Dosu.
Taylor DolezalHead of OSSHow Fresh Are Your Docs? Score Documentation Freshness in CI
A 0-100 freshness signal that catches documentation drift in CI on every PR. Three deterministic checks plus a Claude Code semantic layer for the gray zone.
Taylor DolezalHead of OSSA Claude Code Skill for Auto-Generating Project Docs
Generate your project's entire documentation layer from source code with a single Claude Code skill. Build /doc-it and run it against a real FastAPI project.
Taylor DolezalHead of OSSHow to Catch Documentation Drift with Claude Code and GitHub Actions
Let's craft a GitHub Actions workflow with Claude Code that helps to catch stale docs as you iterate on your code.
Taylor DolezalHead of OSSAlways Up to Date: Using AI to Generate and Maintain Documentation
Keep docs in sync automatically. Dosu generates, updates, and self-documents PRs so your documentation stays accurate with every code change.
The Code Understanding Paradox: When AI Makes Writing Code Fast but Understanding It Slow
I've been thinking about Sonar CEO Tariq Shaukat's recent blog post Solving the Engineering Productivity Paradox from a Dosu angle.
Devin SteinFounder and CEOFrom Maintenance to Innovation: Freeing Developers With AI Automation
Discover how AI automation frees developers from maintenance tasks, boosts productivity, and transforms documentation and support workflows.
Internal vs External Documentation: Audience First
Learn how to create effective documentation by focusing on your audience first. Discover the key differences between internal and external docs and practical strategies for both.
AI Is Better at Maintaining Docs Than Humans
People have dreamed of living documentation–documentation that evolves as fast as your code–for decades but human bandwidth to review and update documentation has always been the bottleneck. Now with AI, we have a way to couple written knowledge to code and get the best of both worlds: easy to understand documentation that evolves with your code.
Devin SteinFounder and CEO7 Data‑Driven Checks to ensure your Documentation ROI is high
Learn how to measure and improve your documentation ROI with these 7 data-driven checks.
Knowledge Management in the AI Era: Why Documentation is More Critical Than Ever
Discover why comprehensive documentation is now essential for AI-powered development teams and how it can transform your engineering productivity in the age of intelligent automation.
What The Mythical Man-Month Got Right About Documentation (And What We Forgot)
Let’s get this out of the way: no one gets into software because they love writing documentation.