Gráficos Gantt Mermaid são úteis quando o plano fica no mesmo repositório das notas de implementação. O texto é versionado e revisável, adequado a lançamentos, migrações e projetos de documentação com poucas tarefas.
Defina datas e IDs explicitamente
gantt
title Publicação da documentação
dateFormat YYYY-MM-DD
axisFormat %b %d
section Pesquisa
Auditar páginas :done, audit, 2026-07-11, 3d
Escolher temas :topics, after audit, 2d
section Entrega
Redigir guias :active, draft, after topics, 6d
Revisão técnica :review, after draft, 2d
Publicar :milestone, publish, after review, 0dIDs como audit e draft são alvos estáveis para after. Os nomes podem mudar sem quebrar dependências. Defina dateFormat antes das datas literais.
Use marcadores com moderação
done, active, crit e milestone destacam estados, mas se tudo for crítico o sinal perde valor. Um marco não tem duração: representa decisão ou entrega.
Trate dependências como comunicação
after draft expressa dependência fim-início. Planejamento real também envolve capacidade, calendários e progresso parcial. Mermaid não é um sistema completo de gestão; para prazos contratuais, use a ferramenta oficial e vincule uma visão simplificada.
Mantenha o plano revisável
Agrupe tarefas, use rótulos curtos e atualize datas junto com a mudança do compromisso. Se passar de uma tela, separe um roadmap com fases e marcos do plano detalhado da fase atual.
Abra o modelo Gantt no editor Mermaid local para validar e exportar SVG ou PNG.