diff --git a/docs/data-model.rst b/docs/data-model.rst
--- a/docs/data-model.rst
+++ b/docs/data-model.rst
@@ -140,11 +140,11 @@
   stable suite of a FOSS distribution.
 
 **visits**
-  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.
 
+  links together software origins with snapshots. Every time, according to
+  Software Heritage clock, an origin is consulted a new visit object is
+  created. Every visit's state change is also recorded (status change from
+  started to finished, new snapshot or metadata added).
 
 Data structure
 --------------