Набір автора документації API
Огляд API, огляд SDK, quickstart, туторіал, how-to, довідник, пояснення, посібник розробника, changelog API, повідомлення про застарівання, посібник з міграції та усунення несправностей.
Посібники
API Overview and Getting Started Template
СтандартAPI landing page: what it does, OpenAPI and Arazzo descriptions, base URLs, auth in 3 steps, first request, key resources, errors, limits, next steps
OpenAPI 3.2.1 (or 3.1.x); Arazzo 1.1.0; Overlay 1.2.0SDK Overview Template
ПовнийSDK landing page: supported-languages matrix, install, auth and config, first call, errors, retries and timeouts, pagination, logging, versioning and support policy
OpenAPI 3.2.1; Semantic Versioning 2.0.0Quickstart Guide Template
СтандартQuickstart page: time-to-first-success target, prerequisites table, three steps with expected output, verify, clean-up, troubleshooting
Diátaxis (tutorial and how-to types, adapted)Tutorial Template (Diátaxis)
СтандартDiátaxis tutorial – learning goals, prerequisites, numbered lessons with visible results, checkpoints, troubleshooting
DiátaxisHow-To Guide Template (Diátaxis)
СтандартGoal-oriented how-to guide: prerequisites table, numbered steps with checks, verification, variations, failure table, worked example
Diátaxis (how-to guide)
Еталонні рішення
REST Endpoint Reference Template
СтандартOne REST endpoint: auth, parameter tables, request example, responses per status, RFC 9457 errors, limits, idempotency, paging, deprecation headers
OpenAPI 3.2.1 (or 3.1.x), Arazzo 1.1.0, Overlay 1.2.0, RFC 9457, RFC 9745, RFC 8594Reference Documentation Template (Diátaxis)
СтандартDiátaxis reference page – neutral, consistently structured entries for functions, types, errors and constants
DiátaxisExplanation Document Template (Diátaxis)
СтандартUnderstanding-oriented explanation: idea in brief, context, mechanism diagram, alternatives considered, trade-offs, misconceptions, worked example
Diátaxis (explanation)Developer and SDK Guide Template
ПовнийDeveloper guide: setup, auth, multi-language quick start, errors, pagination, rate limits, webhooks, sandbox, OpenAPI/Arazzo/Overlay descriptions, versioning
OpenAPI 3.2.1 (or 3.1.x); Arazzo 1.1.0; Overlay 1.2.0; RFC 9745, RFC 8594
Управління змінами
API Changelog Template (OpenAPI 3.2, AsyncAPI 3.1)
ПовнийDated per-version API change log: additive, behavioural and breaking classes, affected operations, OpenAPI diff links, Deprecation and Sunset values, SDK versions
OpenAPI 3.2.1; AsyncAPI 3.1.0; RFC 9745; RFC 8594Deprecation Notice Template (RFC 9745, RFC 8594)
ПовнийCustomer-facing deprecation and sunset notice: affected users, dates, replacement, migration steps, usage detection, Deprecation and Sunset headers, email and changelog variants
RFC 9745; RFC 8594; OpenAPI 3.2.1Migration Guide Template
СтандартUpgrade/migration guide – who is affected, breaking changes table, timeline, checklist, steps, before/after code, rollback
Супровід
Troubleshooting Guide Template
СтандартTroubleshooting guide: diagnostic first steps, symptom index, decision steps per problem with verification, data to collect before contacting support, known issues link
Structure aligned with ISO/IEC/IEEE 26514:2022llms.txt Template for LLM-Friendly Docs
Компактнийllms.txt site index for language models: H1, summary, link-list sections, Optional section, llms-full.txt, .md page mirrors, rel alternate/describedby discovery
llms.txt proposal v2 (llmstxt.org, modified 2026-08-10)