Как документировать API?

Основные варианты: OpenAPI/Swagger spec (YAML/JSON), автогенерация из кода (swaggo), или code-first с ручной спекой. Хорошая документация включает: описание эндпоинтов, параметры с типами, примеры запросов/ответов, коды ошибок, auth требования. Инструменты: Swagger UI для интерактивной доки, Redoc для красивой статической. В Go популярен swaggo — пишешь комментарии над хэндлерами, генерируется OpenAPI spec.