diff --git a/docs/images/status.png b/docs/images/status.png
deleted file mode 100644
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000
GIT binary patch
literal 0
Hc$@<O00001

literal 0
Hc$@<O00001

diff --git a/docs/images/status.uml b/docs/images/status.uml
new file mode 100644
--- /dev/null
+++ b/docs/images/status.uml
@@ -0,0 +1,17 @@
+@startuml
+  [*] --> partial
+  partial --> deposited
+
+  state validation <<choice>>
+
+  deposited --> validation
+
+  validation --> rejected
+  validation --> verified
+
+  verified --> loading
+
+  loading --> done
+
+  loading --> failed
+@enduml
diff --git a/docs/specs/spec-technical.rst b/docs/specs/spec-technical.rst
--- a/docs/specs/spec-technical.rst
+++ b/docs/specs/spec-technical.rst
@@ -92,9 +92,5 @@
       finalized (when the status is changed to ``deposited``)
     - ``swh-id`` is populated once we have the loading result
 
-.. raw:: html
-
-       <!-- {F2884302} -->
-
-.. figure:: ../images/status.png
+.. figure:: ../images/status.svg
    :alt: