October 2026 Summaries

Stripe’s developer documentation is presented as a model of machine-readable, continuously generated API documentation that serves both human developers and AI agents from a shared source of truth. Its approach combines a three-column API reference, immediately usable sandbox credentials for unauthenticated visitors, OpenAPI-based generation with enforced documentation fields, markdown versions of pages, bot-specific markdown responses, and an llms.txt file that directs AI systems toward current products and away from deprecated integrations. The documentation also treats versioning as a product feature through named monthly releases, individual URLs for each changelog entry, explicit breaking-change indicators, and a limited rollback window after upgrades. While the teardown identifies shortcomings such as no centralized deprecations index, occasionally irrelevant AI search suggestions, and product-oriented navigation that can obscure task-based workflows, it argues that many practical improvements are accessible to smaller teams, including markdown routes, LLM guidance, CI checks for missing descriptions, granular changelog URLs, and section-level feedback. The broader conclusion is that documentation should function as a tested, versioned, and instrumented interface for APIs, while AI should help identify and suggest improvements without replacing human publishing decisions.

ReadMe announced Restless, a new AI-focused product designed to help API providers support agents and developers as automated systems account for a growing share of API documentation traffic and usage. Restless combines real-time API logs with evolving documentation and other contextual information, delivering assistance through an MCP server, documentation interfaces, and API responses. Its features include recovery guidance embedded in error responses, agent-accessible debugging based on live logs, a Workbench for users to inspect requests and responses, AI support that can escalate to human teams, and centralized visibility into API and MCP activity. The product is intended to improve over time by incorporating anonymized support insights and usage data, while working alongside ReadMe or other documentation platforms such as Fern and Mintlify. Restless includes 1,000 free monthly credits, with ReadMe customers receiving an additional 4,000 credits, and additional capacity available for purchase.