Scrivo molta documentazione per gli utenti finali così come resoconti operativi, e Mermaid rende estremamente semplice includere grafici, diagrammi, visualizzazioni di flussi di lavoro, ecc. Posso includere il codice grezzo, il che rende più facile per altri (o per il Futuro Me!) apportare modifiche in seguito. Posso usare l'interfaccia web o le estensioni per IDE (ad esempio, VSCode). Ci sono anche plugin per Confluence, ecc. La sintassi non è troppo complicata - fondamentalmente markdown - ma essendo una persona pigra, invece di memorizzarla, ho iniziato a usare strumenti di intelligenza artificiale di terze parti (ad esempio, Gemini) per descrivere ciò che volevo in semplici descrizioni narrative, e lasciare che creasse il codice per me. Successivamente, ho scoperto che le capacità di intelligenza artificiale native all'interno di Mermaid stesso rendevano ancora più facile la creazione di grafici in tempo reale all'interno dell'interfaccia di mermaid.ai. Il prezzo è minimo e ne vale la pena. Davvero non avrei potuto creare questi diagrammi da solo - le mie competenze si fermavano a MS Paint. Il supporto è anche di prim'ordine - molto cordiale, reattivo.

Mi piacciono di più i diagrammi Mermaid per la loro semplicità e flessibilità nella creazione di diagrammi utilizzando testo semplice. Puoi scrivere poche righe di codice per generare diagrammi di flusso, diagrammi di sequenza, diagrammi di Gantt o mappe mentali, il che li rende facili da controllare nelle versioni e integrare nella documentazione. Sono leggeri, facili da aggiornare e ideali per i team tecnici che vogliono incorporare diagrammi direttamente in Markdown, wiki o repository di codice senza utilizzare strumenti grafici pesanti.

Uso il Mermaid Chart da anni, principalmente per diagrammi di sequenza e flowchart, e recentemente per diagrammi di contesto C4. Mi è stato presentato da un collega e ho subito apprezzato come mi permettesse di mantenere la documentazione aggiornata modificando un diagramma centrale di Mermaid. Configurare Mermaid Chart è stato un gioco da ragazzi perché è uno strumento SaaS. Mi permette di creare diagrammi facilmente usando testo chiaro. Lo strumento è fantastico nell'aiutarmi a collaborare con gli utenti finali per tradurre le loro idee in diagrammi visivi e poi iterare rapidamente su di essi. Questo riduce significativamente il rifacimento poiché la comprensione condivisa dei processi viene raggiunta molto prima. La possibilità di salvare i diagrammi come PNG è particolarmente utile e si integra bene con altri software come Confluence, DevOps e Word. Ciò che lo rende il miglior strumento di diagrammazione per me è la sua capacità di eliminare la necessità di posizionare manualmente gli oggetti su una tela, il che è particolarmente vantaggioso dato che ho l'ADHD e posso concentrarmi eccessivamente su tali compiti.