diff --git a/docs/creating.rst b/docs/creating.rst index 7a3224c..75da8ed 100644 --- a/docs/creating.rst +++ b/docs/creating.rst @@ -14,7 +14,8 @@ Creating or Extending Validators Creating Validation Errors -------------------------- -Any validating function that recurses into an instance (e.g. ``properties`` or -``items``) must call ``appendleft`` on the :exc:`ValidationError.path` -attribute of the error in order to properly maintain where in the instance the -error occurred. +Any validating function that validates against a subschema should call +:meth:`ValidatorMixin.descend`, rather than :meth:`ValidatorMixin.iter_errors`. +If it recurses into the instance, or schema, it must set the ``path`` or +``schema_path`` in order to properly maintain where in the instance and schema +the error occurred.