diff --git a/src/DefinitionResolver.php b/src/DefinitionResolver.php
index c242abf..77527f3 100644
--- a/src/DefinitionResolver.php
+++ b/src/DefinitionResolver.php
@@ -151,6 +151,8 @@ class DefinitionResolver
             $context = new Types\Context($namespaceName, $namespaceImportTable);
 
             try {
+                // create() throws when it thinks the doc comment has invalid fields.
+                // For example, a @see tag that is followed by something that doesn't look like a valid fqsen will throw.
                 return $this->docBlockFactory->create($docCommentText, $context);
             } catch (\InvalidArgumentException $e) {
                 return null;