Improve documentation of the enricher

Author: dmolineus

src/Version10/EnricherPluginInterface.php

@@ -12,16 +12,21 @@
 interface EnricherPluginInterface extends ConfigurationPluginInterface
 {
     /**
-     * Enriches the configuration of a specific other
+     * Enriches the configuration of another diagnostics plugin.
+     *
+     * The enricher might be used for several plugins and have to handle the plugin depending on its name and version.
+     *
      * @param string                       $pluginName The name of the plugin which is enriched.
      * @param array                        $pluginConfig The current plugin configuration.
      * @param PluginConfigurationInterface $config The configuration of the enricher plugin itself.
+     *
      * @param EnvironmentInterface         $environment The environment for the
      *
      * @return array
      */
     public function enrich(
         string $pluginName,
+        string $pluginVersion,
         array $pluginConfig,
         PluginConfigurationInterface $config,
         EnvironmentInterface $environment

src/Version10/EnvironmentInterface.php

@@ -4,6 +4,7 @@
 
 namespace Phpcq\PluginApi\Version10;
 
+use Phpcq\PluginApi\Version10\Exception\RuntimeException;
 use Phpcq\PluginApi\Version10\Task\TaskFactoryInterface;
 
 interface EnvironmentInterface
@@ -32,6 +33,11 @@ public function getBuildTempDir(): string;
     /**
      * Get the installed directory of the current plugin.
      *
+     * The installed directory is also the home of the plugin specific generated composer.json. Installed composer
+     * packages will be available in the vendor subdirectory.
+     *
+     * The plugin might
+     *
      * @return string
      */
     public function getInstalledDir(): string;