docstrings: improve wording

capa/features/extractors/base_extractor.py

@@ -328,7 +328,7 @@ class CallHandle:
     reference to an api call extracted by the sandbox.
 
     Attributes:
-        address: call's id address
+        address: call's address, such as event index or id
         inner: sandbox-specific data
     """
 
@@ -445,8 +445,8 @@ class DynamicFeatureExtractor:
     ) -> Iterator[Tuple[Feature, Address]]:
         """
         Yields all features of a call. These include:
-        - api's
-        - arguments
+        - api name
+        - bytes/strings/numbers extracted from arguments
         """
         raise NotImplementedError()
 

capa/features/extractors/cape/process.py

@@ -22,7 +22,7 @@ logger = logging.getLogger(__name__)
 
 def get_threads(behavior: Dict, ph: ProcessHandle) -> Iterator[ThreadHandle]:
     """
-    get a thread's child processes
+    get the threads associated with a given process
     """
 
     process = capa.features.extractors.cape.helpers.find_process(behavior["processes"], ph)