Как писать спецификацию API

В докладе поделюсь знаниями и практиками оформления документа Спецификация API, созданного на основе OpenAPI версии 3.0.1 и Swagger версии 2.0. Мы познакомимся со структурой документа и полями, обязательными к заполнению минимальной документации. Этот доклад будет полезен как начинающим, так и опытным техническим писателям, в работе которых используется в основном подход Docs-as-Сode. Основное внимание уделю полям и практикам их заполнения.