Хочу рассказать про мою находку — mermaid. И то как это сильно упростило мне жизнь в части проектной документации, планирования проектов через Диаграммы Ганта и в целом про разные способы анализа на основе открытых стандартов типа Markdown & Mermaid.
Проблема планирования проектов и дорожных карт за 15 лет опыта
Я занимался проектами разработки где то с 2005 года — более 20 лет. С некоторыми перерывами на переход в чистую разработку. Но постоянно возвращался к управлению проектами и регулярно искал новые инструменты для планирования, описания и постановки задач.
- в 2005 году я делал все в Excel
- потом было 5 лет работы с MS Project
- последние 10 лет плотно работал с Agile инструментами типа JIra, Трелло, Редмайн и т д.
- в последние годы пробовал Яндекс Трекер, Мондей, Ноушен и еще пачку разных сервисов.
Все это время не оставляли мысли о том что все это как то сложно и были видны явные проблемы:
- инструменты постоянно разные и перенос данных между ними это беда
- когда нужно что то согласовать и поправить с сохранением истории — получалось много косвенных затрат на постоянные правки данных в разных инструментах
- с развитием ИИ это все в целом стало выглядеть как что то странное и старое
Как меня удивил Mermaid в условиях использования с искусственным интеллектом
Во первых это открытый стандарт, который уже довольно давно интегрирован в разные Markdown редакторы.
Во вторых можно быстро описать проект и тут же собрать диаграмму ганта с таймлайнами чтобы лучше понять длительность проекта и его этапов. Причем как проекту в целом, так и по каждому его отдельному этапу. Что в целом оказалось сильно удобнее и проще чем все с чем я работал до этого.
Переходы между инструментами идут легко — потому что это стандарт и он поддерживается почти везде где я работаю:
- notion — пишу заметки, ставлю задачи и тут же могу собрать таймлайны по проекту — причем с поддержкой ИИ ассистента — который это делает сильно быстрее меня на основе описания проекта
- anytype — иногда проект очень секретный и не хочется его хранить в облаках — берем anytype и там все тоже самое — только приватно, безопасно и синхронизация с устройствами без облаков через p2p
- как программист я часто использую VS Code + GIT — и там это тоже отлично работает
Все свои наработки я легко могу переносить между инструментами, сохранять хоть в облаках, хоть в git, или синхронизировать между устройствами через p2p.
Притом почти во всех инструментах я могу попросить ИИ обновить план проекта с учетом изменений проектной документации и он это делает быстро и просто.
Что еще может Mermaid?
На сколько я успел выяснить — эта технология гораздо шире чем просто рисовать диаграммы Ганта по проектам.
Вот несколько других типов диаграмм которые я уже активно использую в работе:
- Блок-схемы (Flowchart) — для описания бизнес-процессов и алгоритмов
- Диаграммы последовательности (Sequence Diagram) — отлично подходят для документирования API и взаимодействия между сервисами
- ER-диаграммы — для проектирования структуры баз данных
Это лишь малая часть и на официальном сайте больше информации https://mermaid.js.org/
Сценарии использования
- Разработчики ПО — документируют архитектуру систем, API, алгоритмы и процессы прямо в README файлах и технической документации
- Проектные менеджеры — планируют проекты через диаграммы Ганта, визуализируют зависимости между задачами и отслеживают прогресс
- Бизнес-аналитики — описывают бизнес-процессы, строят блок-схемы для анализа и оптимизации workflow
- Архитекторы данных — проектируют структуру баз данных с помощью ER-диаграмм, документируют связи между таблицами
- DevOps инженеры — визуализируют инфраструктуру, процессы CI/CD, потоки развертывания
- Product Owner’ы — создают roadmap продуктов, планируют спринты, согласовывают планы с командой через версионируемые диаграммы
- Технические писатели — встраивают диаграммы в документацию для лучшего понимания сложных концепций
- Студенты и преподаватели — используют для создания конспектов, курсовых работ, визуализации учебных материалов
- Исследователи — документируют методологию исследований, строят диаграммы для научных статей
- Стартапы и малые команды — быстро прототипируют идеи, планируют развитие продукта без необходимости покупать дорогие инструменты
Резюме
Mermaid оказался для меня идеальным решением для планирования проектов и создания технической документации. Это открытый стандарт, который работает везде — от Notion до VS Code, позволяет быстро создавать диаграммы Ганта прямо в текстовых документах и легко переносить между инструментами. За 20 лет работы с проектами я наконец нашел инструмент, который объединяет простоту, гибкость и современный подход с поддержкой ИИ.
