Add comment on try/catch in DefinitionResolver

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;