diff --git a/tests/test_state.py b/tests/test_state.py
index 36b786b16b86a19ed59f5efa0a473a02b456780f..ea402cdef4386634530cf784b5e076637b98aea8 100644
--- a/tests/test_state.py
+++ b/tests/test_state.py
@@ -32,7 +32,7 @@ def setup_module():
     db.Record("State1").add_parent("State").insert()
     db.Record("State2").add_parent("State").insert()
     db.Record("State3").add_parent("State").insert()
-    # 1->
+    # 1->2
     db.Record("Transition1").add_parent("Transition").add_property(
         "from", "State1").add_property("to", "State2").insert()
     # 2->3
@@ -72,6 +72,7 @@ def setup():
 
 
 def test_plugin_disabled():
+    """Test the behavior when the state machine extension is disabled on the server."""
     admin.set_server_property("EXT_ENTITY_STATE", "DISABLED")
 
     rec = db.Record()
@@ -100,6 +101,7 @@ def test_plugin_disabled():
 
 
 def test_state_message():
+    """State is constant between creation, insertion, retrieval."""
     rec = db.Record()
     rec.add_parent("TestRT")
     rec.state = db.State(model="Model1", name="State1")
@@ -142,7 +144,7 @@ def test_state_transition():
 
 
 def test_transition_not_allowed():
-    """unallowed transitions return errors and do not update the entity"""
+    """Unallowed transitions return errors and do not update the entity."""
     rec = db.Record()
     rec.add_parent("TestRT")
     rec.state = db.State(model="Model1", name="State1")
@@ -248,7 +250,7 @@ def test_state_not_in_state_model():
         0].description == "State does not exist in this StateModel."
 
 
-def test_transition_with_out_state_change():
+def test_transition_without_state_change():
     rec = db.Record()
     rec.description = "old description"
     rec.add_parent("TestRT")