From d1adffe41f328a68fb363ad3b738e7527608c48b Mon Sep 17 00:00:00 2001
From: Ener-Getick <egetick@gmail.com>
Date: Sat, 30 Jul 2016 20:27:51 +0200
Subject: [PATCH] Improve php docs

---
 ApiDocGenerator.php                | 5 +----
 Describer/ApiPlatformDescriber.php | 3 ---
 Describer/ExternalDocDescriber.php | 2 +-
 Describer/SwaggerPhpDescriber.php  | 3 ---
 4 files changed, 2 insertions(+), 11 deletions(-)

diff --git a/ApiDocGenerator.php b/ApiDocGenerator.php
index d058b25..ac93116 100644
--- a/ApiDocGenerator.php
+++ b/ApiDocGenerator.php
@@ -27,10 +27,7 @@ class ApiDocGenerator
         $this->describers = $describers;
     }
 
-    /**
-     * @return Swagger
-     */
-    public function extract()
+    public function extract(): Swagger
     {
         if (null !== $this->swagger) {
             return $this->swagger;
diff --git a/Describer/ApiPlatformDescriber.php b/Describer/ApiPlatformDescriber.php
index 9906e74..499a6df 100644
--- a/Describer/ApiPlatformDescriber.php
+++ b/Describer/ApiPlatformDescriber.php
@@ -16,9 +16,6 @@ use ApiPlatform\Core\Swagger\DocumentationNormalizer;
 
 class ApiPlatformDescriber extends ExternalDocDescriber
 {
-    /**
-     * @param string $projectPath
-     */
     public function __construct(Documentation $documentation, DocumentationNormalizer $normalizer, bool $overwrite = false)
     {
         parent::__construct(function () use ($documentation, $normalizer) {
diff --git a/Describer/ExternalDocDescriber.php b/Describer/ExternalDocDescriber.php
index aee5ce3..a7d83dd 100644
--- a/Describer/ExternalDocDescriber.php
+++ b/Describer/ExternalDocDescriber.php
@@ -20,7 +20,7 @@ class ExternalDocDescriber implements DescriberInterface
 
     /**
      * @param array|callable $externalDoc
-     * @param int            $strategy
+     * @param bool           $overwrite
      */
     public function __construct($externalDoc, bool $overwrite = false)
     {
diff --git a/Describer/SwaggerPhpDescriber.php b/Describer/SwaggerPhpDescriber.php
index f710d72..4d89666 100644
--- a/Describer/SwaggerPhpDescriber.php
+++ b/Describer/SwaggerPhpDescriber.php
@@ -13,9 +13,6 @@ namespace EXSyst\Bundle\ApiDocBundle\Describer;
 
 class SwaggerPhpDescriber extends ExternalDocDescriber
 {
-    /**
-     * @param string $projectPath
-     */
     public function __construct(string $projectPath, bool $overwrite = false)
     {
         parent::__construct(function () use ($projectPath) {