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