📝 Add docstrings to test-improving-code-coverage

config/reference.php

@@ -1266,8 +1266,9 @@
 final class App
 {
     /**
-     * @param ConfigType $config
+     * Provides the application's service and extension configuration.
      *
+     * @param ConfigType $config The configuration structure for the application (see `ConfigType` psalm type aliases defined above).
      * @psalm-return ConfigType
      */
     public static function config(array $config): array
@@ -1344,12 +1345,15 @@ public static function config(array $config): array
 final class Routes
 {
     /**
-     * @param RoutesConfig $config
+     * Builds and returns a routes configuration array for the application.
+     *
+     * The configuration may contain RouteConfig, ImportConfig, or AliasConfig entries and may use environment-scoped keys (e.g. "when@dev").
      *
+     * @param RoutesConfig $config
      * @psalm-return RoutesConfig
      */
     public static function config(array $config): array
     {
         return $config;
     }
-}
+}

src/Service/SatisManager.php

@@ -62,6 +62,17 @@ public function run(): \Generator
         }
     }
 
+    /**
+     * Handle a BuildEvent by executing the Satis build for the event's repository.
+     *
+     * Acquires the build lock, runs the generated Satis process, releases the lock,
+     * and updates the event's status with the process exit code (`1` if an internal
+     * RuntimeException occurs).
+     *
+     * @param BuildEvent $event The build event; its repository (if any) is used to
+     *                          determine the build target and its status will be
+     *                          updated with the process exit code.
+     */
     public function onBuild(BuildEvent $event): void
     {
         $repository = $event->getRepository();
@@ -81,7 +92,16 @@ public function onBuild(BuildEvent $event): void
     }
 
     /**
-     * @throws \JsonException
+     * Build the command argument array for executing a Satis build.
+     *
+     * Constructs a command array based on the configured satis file and output directory,
+     * optionally scoping the build to a single repository and adding extra options or arguments.
+     *
+     * @param string|null $repositoryName Name of a single repository to target, or `null` to include all repositories.
+     * @param array $options Associative or list-style Satis options to include (added via the builder's options API).
+     * @param array $extraArgs Additional positional arguments to append to the command.
+     * @return array The constructed command as an array of command and arguments suitable for Process execution.
+     * @throws \JsonException If encoding the built command to JSON for logging fails.
      */
     protected function getCommandLine(?string $repositoryName = null, array $options = [], array $extraArgs = []): array
     {
@@ -111,4 +131,4 @@ protected function trimLine(string $line): string
     {
         return \mb_trim($line, " \t\n\r\0\x0B\x08");
     }
-}
+}