@see tags are not correctly handled
>>> [!note] Migrated issue
<!-- Drupal.org comment -->
<!-- Migrated from issue #3454780. -->
Reported by: [avpaderno](https://www.drupal.org/user/55077)
Related to !37
>>>
<p>On <a href="https://api.drupal.org/api/drupal/core%21lib%21Drupal%21Core%21Cache%21CacheableRedirectResponse.php/class/CacheableRedirectResponse/11.x">the documentation page for CacheableRedirectResponse</a>, after the short and long description of the class, I see the following text.</p>
<blockquote><p>ableMetadata ableResponseTrait</p></blockquote>
<blockquote><p><img src="https://www.drupal.org/files/issues/2024-06-15/24b58b2b130f2d24233922a591cbf8b4.png" alt="screenshot"></p></blockquote>
<p><a href="https://api.drupal.org/api/drupal/core%21lib%21Drupal%21Core%21Cache%21CacheableRedirectResponse.php/11.x">Looking at the code</a>, I noticed those strings are the <code>@see</code> tags and their content, without the <code>@see \Drupal\Core\Cache\Cache</code> part.</p>
<pre>/**<br> * A RedirectResponse that contains and can expose cacheability metadata.<br> *<br> * Supports Drupal's caching concepts: cache tags for invalidation and cache<br> * contexts for variations.<br> *<br> * @see \Drupal\Core\Cache\Cache<br> * @see \Drupal\Core\Cache\CacheableMetadata<br> * @see \Drupal\Core\Cache\CacheableResponseTrait<br> */</pre><p>This is the first time I noticed this issue. Probably, there are other pages where the same issue is present.</p>
issue