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

What Is Technical Documentation? 2026 Guide & Best Practices
what is technical documentationMay 21, 2026

What Is Technical Documentation? 2026 Guide & Best Practices

Understand what is technical documentation: its types, why most are obsolete, and 2026 best practices for AI-readable docs to get found.

Make Your Docs Discoverable by AI Agents: The 2026 Guide
make your docs discoverable by AI agentsMay 20, 2026

Make Your Docs Discoverable by AI Agents: The 2026 Guide

A guide to make your docs discoverable by AI agents. Learn the technical steps for llms.txt, semantic MDX, sitemaps, and why AI-native platforms are essential.

Docs for AI Agents: The 2026 Guide to Getting Read
docs for ai agentsMay 19, 2026

Docs for AI Agents: The 2026 Guide to Getting Read

Learn to create docs for AI agents that get your product discovered and recommended. This guide covers machine-readable formats, RAG, and practical checklists.

Answer Engine Optimization: A Guide for 2026
answer engine optimizationMay 18, 2026

Answer Engine Optimization: A Guide for 2026

Learn Answer Engine Optimization (AEO) for 2026. This guide covers how to optimize docs for AI, contrasts AEO with SEO, and provides a technical checklist.

llms.txt: Your Guide to AI-Ready Content in 2026
llms.txtMay 17, 2026

llms.txt: Your Guide to AI-Ready Content in 2026

Learn what llms.txt is, how to create it, and why it's not enough. Discover the right way to make your content visible and useful to AI like ChatGPT.

10 Technical Documents Templates for 2026
technical documents templatesMay 16, 2026

10 Technical Documents Templates for 2026

Ditch the Word files. Find the best technical documents templates and platforms for API docs, runbooks, and knowledge bases in this 2026 guide.

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