diff --git a/docs/persistence/README.md b/docs/persistence/README.md
index 68df1addc8..52d4872598 100644
--- a/docs/persistence/README.md
+++ b/docs/persistence/README.md
@@ -40,6 +40,7 @@ use [bbolt].
 [boltdb]: https://github.com/boltdb/bolt
 [bbolt]: https://github.com/etcd-io/bbolt
 
+See [diagrams](#diagrams) below for more details on the interaction.
 
 ## State Store
 
@@ -111,3 +112,10 @@ storage.
 
 
 [hashicorp/raft-autopilot]: https://github.com/hashicorp/raft-autopilot
+
+## Diagrams
+### High-level life of a write
+![Overview](./write-overview.png)
+
+### Deep-dive into write through Raft
+![Deep dive](./write-deep-dive.png)
\ No newline at end of file
diff --git a/docs/persistence/write-deep-dive.png b/docs/persistence/write-deep-dive.png
new file mode 100644
index 0000000000..b3872fb655
Binary files /dev/null and b/docs/persistence/write-deep-dive.png differ
diff --git a/docs/persistence/write-overview.png b/docs/persistence/write-overview.png
new file mode 100644
index 0000000000..e7238c13a2
Binary files /dev/null and b/docs/persistence/write-overview.png differ