Вы когда-нибудь тратили часы на оформление документации, а потом получали комментарий: «Нужно доработать и поменять оформление»? Или, ещё хуже, «А где диаграмма?» — и понимали, что рисовать её вручную в Word — это как пытаться построить небоскрёб с помощью зубочисток и скотча?Не думаю, что открою большой секрет, но видя, как мучаются коллеги, хочу поделиться проверенным подходом. С помощью Markdown, PlantUML и Pandoc можно превратить создание документации в прозрачный технологичный процесс («Документация как код»), а не в бесконечную рутинную пытку. В конце статьи ссылка на готовый репозиторий, который можно сразу адаптировать под свои проекты. Читать далее