diff --git a/docs/data-model.rst b/docs/data-model.rst
--- a/docs/data-model.rst
+++ b/docs/data-model.rst
@@ -143,8 +143,9 @@
   links together software origins with snapshots. Every time an origin is
   consulted a new visit object is created, recording when (according to
   Software Heritage clock) the visit happened and the full snapshot of the
-  state of the software origin at the time.
-
+  state of the software origin at the time. Every visit's state update is also
+  recorded (e.g status change from started to finished, new snapshot or
+  metadata added).
 
 Data structure
 --------------