improved swagger command descriptions

Author: eceltov

app/commands/GenerateSwagger.php

@@ -14,7 +14,8 @@ class GenerateSwagger extends Command
     protected function configure()
     {
         $this->setName(self::$defaultName)->setDescription(
-            'Generate a swagger specification file from existing code.'
+            'Generate an OpenAPI documentation from the temporary file created by the swagger:annotate command.'
+            . ' The temporary file is deleted afterwards.'
         );
     }
 

app/commands/SwaggerAnnotator.php

@@ -21,8 +21,10 @@ class SwaggerAnnotator extends Command
 
     protected function configure(): void
     {
+        $filePath = self::$autogeneratedAnnotationFilePath;
         $this->setName(self::$defaultName)->setDescription(
-            'Annotate all methods with Swagger PHP annotations.'
+            "Extracts endpoint method annotations and puts them into a temporary file that can be used to generate"
+            . " an OpenAPI documentation. The file is located at {$filePath}"
         );
     }