277 подписчиков
Если вы пишите код, то наверняка сталкивались с тем, что вам приходилось рассказывать, как ваш код работает. Очень способствует такому рассказу схемы и диаграммы. Порой схемы и диаграммы даже лучше, чем слова рассказывают про то, как работает ваша программа, приложение, микросервисы, компонент, утилита и т.д. и .т.п.
Хочу расказать вам про один очень успешный, на мой взгляд, проект, который реализует возможность создавать схема прямо из текста. Это очень удобно! Более того, такие схемы поддреживаются, например, в GitHub. Это значит, что вы можете писать более "пооезную" документацию для разработчитов. Поверьте, схема лишними не бывают.
Поддерживать схему, нарисованные в специальных графических редакторах, это очень сложно (а мне просто лень) и тратиться очень много времени. Куда проще изменить текст, причем, достаточно простой по формату, чтобы схема обновилась.
Около минуты
18 августа 2022