Field notes on docs, AI, and the web

How great teams actually ship docs.

Long-form writing on documentation, AI-readable content, the editor we wish existed, and the change-management problem nobody talks about.

— Latest

Recent writing

The Best Technical Writing Examples 2026: Real Docs That Actually Work
● technical writingFeb 22, 2026

The Best Technical Writing Examples 2026: Real Docs That Actually Work

See the technical writing examples 2026 that set the standard. From Stripe's API docs to Figma's guides - what makes them convert and why.

7 Incredible API Documentation Examples to Learn From in 2026
● api documentation examplesFeb 21, 2026

7 Incredible API Documentation Examples to Learn From in 2026

Explore 7 standout API documentation examples from Stripe, Twilio, and more. Learn the strategies behind great docs and how to replicate their success.

Your Step by Step Guide to Creating Developer Docs in Minutes
● step by step guideFeb 20, 2026

Your Step by Step Guide to Creating Developer Docs in Minutes

A practical step by step guide to creating developer docs. Learn to convert OpenAPI specs or READMEs into searchable sites quickly and efficiently.

How to Make Your Documentation AI-Agent Friendly (2026 Guide)
● AI DocumentationFeb 12, 2026

How to Make Your Documentation AI-Agent Friendly (2026 Guide)

Learn how to optimize your developer documentation for AI agents like Claude, ChatGPT, and Cursor. Practical tips for llms.txt, structured content, and machine-readable docs.

Why AI Agents Can't Read Your Documentation (And How to Fix It)
● AI DocumentationFeb 12, 2026

Why AI Agents Can't Read Your Documentation (And How to Fix It)

Your docs are invisible to AI assistants like Claude, ChatGPT, and Cursor. Here's why, and the 3 changes that will fix it.

How to Create an llms.txt File for Your Documentation (2025 Guide)
● llms.txtJan 28, 2026

How to Create an llms.txt File for Your Documentation (2025 Guide)

Learn how to create an llms.txt file that helps AI assistants like ChatGPT and Claude understand your documentation. Free generator included.

Start for free

Ready to ship better docs?

Join developers who chose simplicity over enterprise pricing. Instant setup, no git required.

Get started free
Blog - Dokly | Documentation Tips, Tutorials & Best Practices