Add extra deprecation

Author: jaapio

src/DocBlock/Tags/Factory/ParamFactory.php

@@ -4,6 +4,7 @@
 
 namespace phpDocumentor\Reflection\DocBlock\Tags\Factory;
 
+use Doctrine\Deprecations\Deprecation;
 use phpDocumentor\Reflection\DocBlock\DescriptionFactory;
 use phpDocumentor\Reflection\DocBlock\Tag;
 use phpDocumentor\Reflection\DocBlock\Tags\Param;
@@ -37,6 +38,14 @@ public function create(PhpDocTagNode $node, Context $context): Tag
         $tagValue = $node->value;
 
         if ($tagValue instanceof InvalidTagValueNode) {
+            Deprecation::trigger(
+                'phpdocumentor/reflection-docblock',
+                'https://github.com/phpDocumentor/ReflectionDocBlock/issues/362',
+                sprintf(
+                    'Param tag value "%s" is invalid, falling back to legacy parsing. Please update your docblocks.',
+                    $tagValue->value
+                )
+            );
             return Param::create($tagValue->value, $this->typeResolver, $this->descriptionFactory, $context);
         }