Diagrammi di Venn in Confluence

Un diagramma di Venn mostra gli insiemi come cerchi e ciò che hanno in comune dove i cerchi si sovrappongono.

Ultimo aggiornamento

Quando usarlo

Usa un diagramma di Venn per spiegare una sovrapposizione: che cosa coprono i test unitari, di integrazione ed end-to-end, quali competenze condividono due ruoli, dove due prodotti competono. Due o tre insiemi si leggono bene; oltre diventa difficile da seguire.

Esempio

Questo è il codice del modello Testing strategy: tre livelli di test, con ciò che ciascuno copre da solo e insieme agli altri.

venn-beta
  title Testing strategy
  set Unit
    text U1["Domain logic"]
  set Integration
    text I1["Database queries"]
  set EndToEnd["End-to-end"]
    text E1["Critical user flows"]
  union Unit,Integration["API contract"]
  union Unit,Integration,EndToEnd["Payment flow"]

Vellnar Diagrams lo disegna così:

Cambia una riga e il diagramma cambia con lei. A nessuno serve il file originale del disegno, perché non esiste: il codice è il diagramma.

Aggiungerlo a una pagina di Confluence

  1. Modifica una pagina di Confluence e scrivi /mermaid dove vuoi il diagramma.
  2. Seleziona Mermaid diagram. Si apre l’editor con l’elenco dei modelli.
  3. Scegli un modello, oppure Start blank e incolla il codice qui sopra. L’anteprima segue ogni tasto.
  4. Scegli Save. Il diagramma compare nella pagina.

La documentazione spiega l’editor, le impostazioni e le esportazioni.

Modelli

Il pulsante Templates dell’editor ha un modello pronto per questo tipo:

  • Testing strategy: Tre livelli di test, con ciò che ciascuno copre da solo e insieme agli altri.

Sintassi

Il codice inizia con venn-beta. La documentazione di Mermaid (in inglese) descrive ogni elemento della sintassi. Vellnar Diagrams lo disegna con Mermaid 12.3; se una riga ha un errore, l’editor segna la riga e tiene a schermo l’ultimo diagramma valido.

Altro

  • Mermaid in Confluence: come funzionano i diagrammi scritti come codice in una pagina, e tutti i tipi di diagramma.
  • Sicurezza: l’app non chiede nessun permesso e non manda nulla fuori da Atlassian.