clarify get_invalid_validation to mention only results from direct children are returned

Author: andrewelamb

synapseclient/models/mixins/json_schema.py

@@ -977,6 +977,10 @@ async def get_invalid_validation_async(
         """
         Get invalid JSON schema validation results for a container entity.
 
+        Note: This only checks the direct children of this entity. It does not
+        check this entity itself, and it does not check grandchildren (entities
+        nested two or more levels below this entity).
+
         Arguments:
             synapse_client (Optional[Synapse], optional): The Synapse client instance. If not provided,
                 the last created instance from the Synapse class constructor will be used.
@@ -1126,6 +1130,10 @@ def get_invalid_validation(
         """
         Get invalid JSON schema validation results for a container entity.
 
+        Note: This only checks the direct children of this entity. It does not
+        check this entity itself, and it does not check grandchildren (entities
+        nested two or more levels below this entity).
+
         Arguments:
             synapse_client (Optional[Synapse], optional): The Synapse client instance. If not provided,
                 the last created instance from the Synapse class constructor will be used.