Описание API/SDK, Docs as Code
Генерация из кода: ещё один способ поддерживать актуальность документации
Доклад был на прошедшей конференции TechWriter Days 1 и сейчас находится в архиве.
Обсудим проблемы синхронизации документации и кодовой базы продукта, проанализируем причины, выработаем стратегию их решения. Узнаем, как перестроить процесс разработки так, чтобы документация всегда была актуальной. Внедрим автоматизированные инструменты генерации документации из кода. Научимся писать тесты и размечать их для генератора документации. Генерация из кода: ещё один способ поддерживать актуальность документации from Vladislav Orlikov