Update docs for descend method

1 files changed, 5 insertions, 4 deletions

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.