Wardley maps in Confluence

A Wardley map places the parts of a service by how visible they are to the user and how mature they are.

Last updated

When to use it

Use a Wardley map for strategy questions such as build or buy. Components sit on a value chain from the user need down to infrastructure, and on an axis from new and uncertain to commodity. Parts on the right are usually better bought than built.

Example

This is the code of the Build vs buy template: a platform value chain from user to compute along the evolution axis.

wardley-beta
  title Platform build vs buy

  evolution Genesis -> Custom built -> Product -> Commodity

  anchor User [0.95, 0.65]
  component "Web app" [0.80, 0.70]
  component "Recommendation engine" [0.60, 0.35] (build)
  component Authentication [0.55, 0.65] (buy)
  component Database [0.30, 0.80]
  component Compute [0.15, 0.90] (outsource)

  User -> "Web app"
  "Web app" -> "Recommendation engine"
  "Web app" -> Authentication
  "Recommendation engine" -> Database
  Authentication -> Database
  Database -> Compute

  evolve Authentication 0.85
  evolve "Recommendation engine" 0.50

Vellnar Diagrams draws it like this:

Change a line and the diagram changes with it. Nobody needs the original drawing file, because there is none: the code is the diagram.

Add it to a Confluence page

  1. Edit a Confluence page and type /mermaid where the diagram should go.
  2. Select Mermaid diagram. The editor opens with the template list.
  3. Pick a template, or choose Start blank and paste the code above. The preview follows every keystroke.
  4. Choose Save. The diagram appears on the page.

The documentation covers the editor, the settings and the exports.

Templates

The Templates button in the editor has one Wardley map ready to use:

  • Build vs buy: A platform value chain from user to compute along the evolution axis.

Syntax

The code of a Wardley map starts with wardley-beta. The Mermaid documentation describes every element of the syntax. Vellnar Diagrams draws it with Mermaid 12.3; if a line has an error, the editor marks the line and keeps the last valid diagram on screen.

More

  • Mermaid in Confluence: how diagrams as code work in a page, and every diagram type.
  • Security: the app asks for no permissions and sends nothing outside Atlassian.