From 65363b7390212f70fb837a6b407a7e1bc0eca108 Mon Sep 17 00:00:00 2001
From: Rob Lourens <roblourens@gmail.com>
Date: Tue, 6 Jun 2017 14:39:44 -0700
Subject: [PATCH] Add comment on try/catch in DefinitionResolver

---
 src/DefinitionResolver.php | 2 ++
 1 file changed, 2 insertions(+)

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;