phpDocumentor / phpDocumentor

src/phpDocumentor/Descriptor/Filter/Filter.php

Doc Comments +1 added lines, -1 removed lines

@@ -47,7 +47,7 @@
     /**
      * Filters the given Descriptor and returns the altered object.
      *
-     * @param TDescriptor $descriptor
+     * @param Filterable $descriptor
      *
      * @return TDescriptor|null
      *

src/phpDocumentor/Transformer/Writer/Twig/CommonMarkFactory.php

Doc Comments +1 added lines, -1 removed lines

@@ -10,7 +10,7 @@
 
 final class CommonMarkFactory
 {
-    /** @param iterable<ExtensionInterface> $extensions */
+    /** @param \League\CommonMark\Extension\DisallowedRawHtml\DisallowedRawHtmlExtension[] $extensions */
     public function createConverter(iterable $extensions) : CommonMarkConverter
     {
         $environment = Environment::createCommonMarkEnvironment();

src/Guides/RestructuredText/NodeFactory/NodeInstantiator.php

Doc Comments +4 added lines

@@ -27,6 +27,10 @@
     /** @var Environment|null */
     private $environment;
 
+    /**
+     * @param NodeRendererFactory $nodeRendererFactory
+     * @param Environment $environment
+     */
     public function __construct(
         string $type,
         string $className,

src/phpDocumentor/Descriptor/ProjectDescriptorBuilder.php

Doc Comments +3 added lines, -3 removed lines

@@ -126,9 +126,9 @@ 
     /**
      * Analyzes a Descriptor and alters its state based on its state or even removes the descriptor.
      *
-     * @param TDescriptor $descriptor
+     * @param Filterable $descriptor
      *
-     * @return TDescriptor|null
+     * @return Filter\TDescriptor|null
      *
      * @template TDescriptor as Filterable
      */
@@ -141,7 +141,7 @@ 
      * Filters a descriptor, validates it, stores the validation results and returns the transmuted object or null
      * if it is supposed to be removed.
      *
-     * @param TDescriptor $descriptor
+     * @param Descriptor $descriptor
      *
      * @return TDescriptor|null
      *

src/Guides/Renderers/Html/TocNodeRenderer.php

Doc Comments +1 added lines

@@ -67,6 +67,7 @@
     /**
      * @param mixed[][] $titles
      * @param mixed[][] $tocItems
+     * @param string $url
      */
     private function buildLevel(
         ?string $url,

src/phpDocumentor/Descriptor/Builder/Reflector/Docblock/DescriptionAssemblerReducer.php

Doc Comments +1 added lines, -1 removed lines

@@ -19,7 +19,7 @@
 final class DescriptionAssemblerReducer extends AssemblerAbstract implements AssemblerReducer
 {
     /**
-     * @return DescriptorAbstract|TagDescriptor|null
+     * @return null|\phpDocumentor\Descriptor\Builder\T
      */
     public function create(object $data, ?Descriptor $descriptor = null) : ?Descriptor
     {

src/phpDocumentor/Descriptor/Collection.php

Doc Comments +1 added lines, -1 removed lines

@@ -96,7 +96,7 @@
      * @param string|int $index
      * @param ?TChild      $valueIfEmpty If the index does not exist it will be created with this value and returned.
      *
-     * @return TChild The contents of the element with the given index and the provided default if the key
+     * @return T|null The contents of the element with the given index and the provided default if the key
      *                doesn't exist.
      *
      * @psalm-return ($valueIfEmpty is null ? ?TChild: TChild)