Документация без боли или создаём технические шедевры с Pandoc и PlantUML
<img src="https://habrastorage.org/getpro/habr/upload_files/838/7d3/930/8387d39303e2d2d326665e884a99ab1d.jpg" /><p>Вы когда-нибудь тратили часы на оформление документации, а потом получали комментарий: «Нужно доработать и поменять оформление»? Или, ещё хуже, «А где диаграмма?» — и понимали, что рисовать её вручную в Word — это как пытаться построить небоскрёб с помощью зубочисток и скотча?</p><p>Не думаю, что открою большой секрет, но видя, как мучаются коллеги, хочу поделиться проверенным подходом. С помощью Markdown, PlantUML и Pandoc можно превратить создание документации в прозрачный технологичный процесс («Документация как код»), а не в бесконечную рутинную пытку. В конце статьи ссылка на готовый репозиторий, который можно сразу адаптировать под свои проекты.</p> <a href="https://habr.com/ru/articles/1081828/?utm_source=habrahabr&utm_medium=rss&utm_campaign=1081828#habracut">Читать далее</a>