update Converter.select_tag docstring

asdf-format · Jun 12, 2023 · ec124f1 · ec124f1
1 parent 1ea847f
commit ec124f1
Showing 1 changed file with 6 additions and 4 deletions.
diff --git a/asdf/extension/_converter.py b/asdf/extension/_converter.py
@@ -76,9 +76,11 @@ def select_tag(self, obj, tags, ctx):
 
         Returns
         -------
-        str
+        str or None
             The selected tag.  Should be one of the tags passed
-            to this method in the `tags` parameter.
+            to this method in the `tags` parameter.  If `None`
+            the result of ``to_yaml_tree`` will be used to look
+            up the next converter for this object.
         """
         return tags[0]
 
@@ -257,8 +259,8 @@ def select_tag(self, obj, ctx):
 
         Returns
         -------
-        str
-            Selected tag.
+        str or None
+            Selected tag or `None` to defer conversion.
         """
         method = getattr(self._delegate, "select_tag", None)
         if method is None: