Exportar um fluxo Mermaid fácil de seguir
Crie um pequeno fluxo de revisão Mermaid, verifique os ramos e o retorno e exporte um diagrama legível para a próxima entrega.
Um bom fluxograma permite seguir uma decisão sem pedir ao autor que explique cada seta. Comece em Mermaid para imagem com um processo pequeno que consiga verificar. Aqui usamos um ciclo de revisão: um rascunho passa pela verificação dos factos ou regressa para ser revisto.
Anote primeiro o início, a decisão e o resultado. O exemplo tem quatro nós: preparar a fonte, verificar os factos, exportar e rever. A revisão regressa à mesma decisão. Esse retorno é importante: sem ele, a imagem sugeriria que rever termina o processo.
Atribua identificadores estáveis aos nós e use os rótulos visíveis para descrever o trabalho. Draft e Review são identificadores; as frases dentro das formas são os rótulos. A documentação de fluxogramas Mermaid explica esta distinção e a sintaxe de direção.
A primeira linha define um fluxo da esquerda para a direita. Os dois ramos identificados tornam a decisão explícita sem depender apenas da cor. É um processo de demonstração, não uma prova de que um lançamento real passou a revisão.
Use a imagem numa entrega editorial ou num documento de processo curto. Percorra ambos os caminhos: o ramo aprovado chega à exportação; o outro passa pela revisão e volta à verificação dos factos.
Se a renderização falhar, verifique primeiro os parênteses retos e as chavetas dos rótulos e formas. Reduza o diagrama à primeira ligação e acrescente as restantes linhas uma de cada vez. Assim limita o problema sem mudar todas as opções de disposição ao mesmo tempo.
Se aparecer um nó inesperado, compare o seu identificador com o pretendido. Reutilizar o mesmo identificador liga ao mesmo nó; uma gralha pode descrever outro. Se o gráfico for gerado mas as setas apontarem para o passo errado, a sintaxe pode estar válida e o processo errado. Leia-o em voz alta como uma sequência de decisões.
Mantenha os rótulos dos ramos curtos e o diagrama suficientemente grande para o destino. Um processo horizontal largo pode precisar de disposição vertical ou de vários diagramas pequenos numa página estreita. Reveja a disposição depois de alterar a direção.
Inspecione o ficheiro descarregado para detetar rótulos cortados e pontas de seta ambíguas. Inclua um resumo textual do processo e guarde a fonte Mermaid para futuras alterações. Exporte o diagrama Mermaid revisto quando todos os caminhos fizerem sentido.
Guias relacionados: evitar erros comuns de Markdown e criar tabelas Markdown legíveis.