diff --git a/apps/dicty-frontpage/docs/EditableContentFlow.md b/apps/dicty-frontpage/docs/EditableContentFlow.md
new file mode 100644
index 0000000000..cba0a8624d
--- /dev/null
+++ b/apps/dicty-frontpage/docs/EditableContentFlow.md
@@ -0,0 +1,32 @@
+## Unauthorized User
+
+```mermaid
+flowchart TD
+
+A["/show"]
+B[Show]
+C[ContentView]
+D["Editor editable={false}"]
+A --> B --> C --> D
+```
+
+## Authorized User
+
+```mermaid
+flowchart TD
+
+A["/editable"]
+B["Editable (QUERY)"]
+C[EditableView]
+D["Editor editable={false}"]
+E["EditButton (navigate to /edit)"]
+F["/edit"]
+G["Edit (QUERY)"]
+H[EditView]
+I["Editor editable={true}"]
+
+A --> B -->|data| C
+C -->|data| D
+C --> E
+F --> G -->|data|H -->|data|I
+```