diff --git a/capa/features/extractors/vmray/models.py b/capa/features/extractors/vmray/models.py
index 4ebbb436..d0897c82 100644
--- a/capa/features/extractors/vmray/models.py
+++ b/capa/features/extractors/vmray/models.py
@@ -72,7 +72,7 @@ def validate_param_list(value):
         return [value]
 
 
-# convert the input value to a Python int type before inner validation is called
+# convert the input value to a Python int type before inner validation (int) is called
 HexInt = Annotated[int, BeforeValidator(validate_hex_int)]
 
 
@@ -88,9 +88,9 @@ class Param(BaseModel):
     deref: Optional[ParamDeref] = None
 
 
-# params may be stored as a list of Param or a single Param so we ensure
-# the input value to Python list type before the inner validation is called
-# to make it much easier to parse later
+# params may be stored as a list of Param or a single Param so we convert
+# the input value to Python list type before the inner validation (List[Param])
+# is called
 ParamList = Annotated[List[Param], BeforeValidator(validate_param_list)]