Improve phpdoc

Author: Kirill Nesmeyanov

src/Parser/Comment/RegexCommentParser.php

@@ -79,18 +79,18 @@ private function lex(string $docblock): iterable
      * Returns significant parts of the DocBlock comment with their offsets of
      * the returned section, relative to the beginning.
      *
-     * ```php
+     * ```
      * $result = $reader->read(<<<'DOC'
      *      /**
      *       * Example line 1
      *       *
-     *       * @tag1 type Description of tag1
-     *       *∕
+     *       * @​tag1 type Description of tag1
+     *       *​/
      *      DOC);
      *
      * // The $result contains:
      * // object(Segment) { offset: 7, text: 'Example line 1' }
-     * // object(Segment) { offset: 28, text: '@tag1 type Description of tag1' }
+     * // object(Segment) { offset: 28, text: '@​tag1 type Description of tag1' }
      * ```
      *
      * @return iterable<array-key, Segment>

src/Parser/Description/DescriptionParserInterface.php

@@ -13,7 +13,7 @@ interface DescriptionParserInterface
      *
      * ```php
      * $description = $parser->parse(<<<'DOC'
-     *      This is a description with {@link Example}.
+     *      This is a description with {@​link Example}.
      *      DOC);
      *
      * // $description MAY contains:

src/Parser/Tag/TagParserInterface.php

@@ -12,8 +12,8 @@ interface TagParserInterface
     /**
      * Returns concrete tag instance by the tag signature.
      *
-     * ```php
-     * $tag = $parser->parse('@param string $tag');
+     * ```
+     * $tag = $parser->parse('@​param string $tag');
      *
      * // $tag may contains:
      * // object(ParamTag) {