doc: Replace architecture SVG with mermaid

1 files changed, 17 insertions, 1 deletions

diff --git a/README.md b/README.md
index 4edd3efa4..860601a89 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,23 @@ GitLab end up in Gitaly.
 
 High-level architecture overview:
 
-![Gitaly architecture](doc/img/architecture.svg)
+```mermaid
+graph LR
+
+  subgraph "Gitaly Service"                                                
+  Gitaly == git ==> Filesystem
+  Gitaly -- "libgit2 / Rugged" --> Filesystem[(Filesystem)]
+  end
+
+  subgraph "Clients"
+    Rails[gitlab-rails] --> Gitaly
+    Workhorse --> Gitaly
+    Shell[gitlab-shell] -- command-line\nclient --> Gitaly
+    Gitaly -. Authorization .-> Rails
+  end
+
+  Rails -. Rugged .-> Filesystem
+```
 
 ### Gitaly clients