Diagrammi di Ishikawa in Confluence

Un diagramma di Ishikawa, detto anche a lisca di pesce, ordina in categorie le possibili cause di un problema.

Ultimo aggiornamento

Quando usarlo

Usa un diagramma di Ishikawa in un post-mortem o in una revisione di qualità. Il problema è la testa del pesce; ogni lisca è una categoria, come persone, processo o strumenti, con le sue cause. Spinge il team a guardare ogni categoria prima di scegliere una causa.

Esempio

Questo è il codice del modello Outage root causes: il post-mortem a lisca di pesce di un’interruzione, con le cause in sei categorie.

ishikawa-beta
  Checkout down for 18 minutes
  Code
    Null pointer in cart total
    Retry loop without backoff
  Database
    Connection pool exhausted
    Missing index on orders table
  Configuration
    Wrong timeout in production
    Feature flag left enabled
  Monitoring
    No alert on error rate
    Dashboard showed stale data
  External dependencies
    Payment gateway slow
    DNS resolver timeouts
  Release process
    Deployed on Friday evening
    Canary stage skipped

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:

  • Outage root causes: Il post-mortem a lisca di pesce di un’interruzione, con le cause in sei categorie.

Sintassi

Il codice inizia con ishikawa-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.