- Understand your audience: Tailor your content for its intended audience, whether it's a human, agent, or LLM.
- Use code samples and graphics: Reduce walls of text with better information density. Multimodal LLMs can already grok these.
- Organize your docs: Good information architecture has many benefits for discovery, search, and LLM training.
- Maintain your docs: This is the hardest one, but nothing else matters if you let your docs rot. Include docs updates as an ongoing part of your development process.
Our newest edition to account for AI is still the 1st edition. Except now, you have humans and LLMs consuming and leveraging your docs. LLMs can't manufacture context and precise judgment as well as humans, which is where great documentation practices are more important than ever.