diff --git a/src/caoscrawler/identifiable_adapters.py b/src/caoscrawler/identifiable_adapters.py
index da31fa3979113d2a610bee400eb3bef183230957..9be539fe0842e3ce24b68060fa2288cdc4c531b2 100644
--- a/src/caoscrawler/identifiable_adapters.py
+++ b/src/caoscrawler/identifiable_adapters.py
@@ -84,14 +84,15 @@ class IdentifiableAdapter(metaclass=ABCMeta):
 
 Some terms:
 
-- *Registered identifiable* is defined as an identifiable with:
-    - A record type as the parent
-    - A list of properties
-    - A list of referenced by statements
-- *Identifiable* is the concrete identifiable, e.g. the Record based on
-    the registered identifiable with all the values filled in.
-- *Identified record* is the result of retrieving a record based on the
-    identifiable from the database.
+- A *registered identifiable* defines an identifiable template, for example by specifying:
+    - Parent record types
+    - Properties
+    - ``is_referenced_by`` statements
+- An *identifiable* belongs to a concrete record.  It consists of identifying attributes which "fill
+  in" the *registered identifiable*.  In code, it can be represented as a Record based on the
+ *registered identifiable* with all the values filled in.
+- An *identified record* is the result of retrieving a record from the database, based on the
+  *identifiable* (and its values).
 
 General question to clarify: