Blog: Best practices
Modern docs playbook
Five plays from Coinbase, Anthropic, Anaconda, RV Tech, and Decagon on making knowledge work for humans and agents.
How Claude Code's documentation team makes feedback actionable with Mintlify
Anthropic's Technical Content Engineer for Claude Code shares how she uses Mintlify and Claude to automate documentation improvements from user feedback.
Your documentation is a demand channel
Documentation is often the highest-traffic, highest-intent surface in your entire funnel. It's the first place a buyer visits before trying your product. It's where agents surface and push your product to prospects.
5 things you didn't know you could do in the Mintlify web editor
The Mintlify web editor can do more than you think, here are five features that make it easy for your whole team to contribute to docs.
Docs on autopilot: From zero to self-maintaining with Mintlify
How Mintlify's auto-generated docs and automations combine to take documentation from nonexistent to self-maintaining.
8 ways teams use Mintlify to keep docs updated automatically
A use-case-driven guide to automating documentation maintenance with Mintlify, featuring automations code snippets for eight real-world automation patterns.
Knowledge management systems for technical teams
Learn what makes developer knowledge management systems successful, and how to build systems that engineering teams will actually use and get value from.
Why more product managers are switching to Mintlify
Understand why product managers are using Mintlify to help support org-wide goals.
Take control of your documentation system
New features for technical writers who need customizable, flexible documentation systems.
Almost half your docs traffic is AI, time to understand the agent experience
Nearly half of all the traffic to your documentation site is now AI agents. How can you create a great agent experience?
@mintlify for better docs, faster
The improved agent means better contributions from my team and fewer docs tasks stuck in the backlog.
Real llms.txt examples from leading tech companies (and what they got right)
A practical look at real llms.txt files from leading developer platforms like Anthropic, Vercel, Stripe, and Cloudflare.
Improved agent experience with llms.txt and content negotiation
Clear, accessible documentation is a prerequisite for agents to successfully perform real world tasks. By improving llms.txt discoverability, we reduce friction in how agents find and consume the documentation they depend on.
Why documentation is one of the most important surfaces for marketers
A look at why documentation is one of the most influential surfaces in a technical product’s funnel, how it shapes evaluation and adoption, and why marketers should treat it as a core part of their narrative.
How I built our knowledge base in an afternoon
Migrating content from multiple sources to Mintlify and building a knowledge base in hours, not weeks.
How Pinecone writes documentation
Jesse Seldess runs documentation at Pinecone, where he's shaping how developers learn and succeed with one of the leading vector database platforms. Previously, he's scaled developer education from the ground up at renowned organizations like Cockroach Labs.
My quick formula for docs that convert
You probably don't immediately notice the design when you walk into a well-designed store. However, you end up finding what you need without wandering, and you move from browsing to buying without getting frustrated. You may notice that you had a pleasant shopping experience, but you may not realize that every part of the environment is intentional: the lighting, the aisles, the checkout flow, even what is placed at eye level.
How Anaconda writes documentation
We sat down with Idan Englander, Manager of Technical Writing at Anaconda, to discuss how he scaled from being a solo writer, what documentation processes actually work, and where AI fits (and doesn't) in the writing workflow. If you're curious about more of Idan's writing principles, check out our Guide to Technical Writing.
How to audit and overhaul your software documentation
One of the most common tickets when I join any new company is some variation of "Update X in the documentation." Most teams know the importance of keeping software documentation up to date, but in practice, it often falls to the bottom of their priority list.
What is MCP and how to get started
The Model Context Protocol was introduced by Anthropic in November 2024 to standardize how LLMs connect to different data sources and tools, acting like a universal adapter for AI applications.
Should you build or buy an API documentation tool?
For companies that rely on a strong developer experience, technical documentation is more than just a helpful resource—it is a key differentiator.
When do you really need a monorepo?
Software engineering teams often face an important decision: "Should all projects live in one repository or be split across multiple repositories?" This decision impacts build times, CI/CD pipelines, dependency management, and even documentation accuracy.
Breaking down common documentation mistakes
Good documentation just feels right, while bad docs leave you frustrated—but pinpointing what went wrong can be tough.
Five changelog principles from best-in-class developer brands
Changelogs are an underrated but critical component of documentation.