input-output-hk · joseph-fajen · Dec 19, 2023 · Dec 19, 2023 · Dec 19, 2023 · Dec 19, 2023
diff --git a/docs/user-journey/_category_.json b/docs/user-journey/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "User Journey",
+  "position": 5
+}
diff --git a/docs/user-journey/builder.md b/docs/user-journey/builder.md
@@ -0,0 +1,8 @@
+---
+title: Builder (citizen developer) journey
+sidebar_position: 50
+---
+
+A business owner or entrepreneur who is managing a team of developers to build smart contracts and DApps. Lines up all the pieces to make a project happen. Needs to understand the big picture.
+
+![Builder journey](../../static/img/builder-journey.png)
diff --git a/docs/user-journey/contract-designer.md b/docs/user-journey/contract-designer.md
@@ -0,0 +1,8 @@
+---
+title: Contract designer journey
+sidebar_position: 30
+---
+
+A developer working with code and the Marlowe DSL language. Uses the Playground to test, iterate, and refine the contract design. May reference contract examples found in places like the Marlowe starter kit and Marlowe Github repository.
+
+![Contract Designer Journey](../../static/img/contract-designer-journey.png)
diff --git a/docs/user-journey/developer.md b/docs/user-journey/developer.md
@@ -0,0 +1,8 @@
+---
+title: Dapp developer journey
+sidebar_position: 40
+---
+
+A developer working with code and the Marlowe DSL language. Uses developer tools such as the prototype example DApps and TS-SDK. The prototype examples offer guidance on ways to implement DApp functionality.
+
+![DApp Developer Journey](../../static/img/dapp-developer-journey.png)
diff --git a/docs/user-journey/marlowe-ecosystem.md b/docs/user-journey/marlowe-ecosystem.md
@@ -0,0 +1,8 @@
+---
+title: Marlowe Ecosystem
+sidebar_position: 10
+---
+
+Provides the resources for users to design, validate, and deploy financial smart contracts. Enables coding in a domain-specific language, simulating contracts in the Playground, and executing them with various development tools. Ensures safety through rigorous testing and formal proofs, and accommodating both novice and expert users for a wide range of use cases. Offers example contracts and prototype DApps for customization.
+
+![Marlowe Ecosystem](../../static/img/Marlowe_Ecosystem_image.png)
diff --git a/docs/user-journey/web3-user.md b/docs/user-journey/web3-user.md
@@ -0,0 +1,8 @@
+---
+title: Web3 user journey
+sidebar_position: 20
+---
+
+A DApp user who fulfills their role as a participant in a contract transaction. Connects their wallet to a specific DApp.
+
+![Web3 User Journey](../../static/img/web3-user-journey.png)
diff --git a/static/img/Marlowe_Ecosystem_image.png b/static/img/Marlowe_Ecosystem_image.png
diff --git a/static/img/builder-journey.png b/static/img/builder-journey.png
diff --git a/static/img/contract-designer-journey.png b/static/img/contract-designer-journey.png
diff --git a/static/img/dapp-developer-journey.png b/static/img/dapp-developer-journey.png
diff --git a/static/img/web3-user-journey.png b/static/img/web3-user-journey.png