Improve comments

src/Execution/ReportingErrorHandler.php

@@ -18,8 +18,10 @@ public function __invoke(?Error $error, \Closure $next): ?array
             return $next(null);
         }
 
-        // Client-safe errors are assumed to be something that a client can handle
-        // or is expected to happen, e.g. wrong syntax, authentication or validation
+        // Client-safe errors are assumed to be something that:
+        // - a client can understand and handle
+        // - were caused by client misuse, e.g. wrong syntax, authentication, validation
+        // Thus, they are typically not actionable for server developers.
         if ($error->isClientSafe()) {
             return $next($error);
         }

src/GraphQL.php

@@ -310,7 +310,7 @@ protected function errorsHandler(): callable
     {
         // @phpstan-ignore-next-line callable is not recognized correctly and can not be type-hinted to match
         return $this->errorsHandler ??= function (array $errors, callable $formatter): array {
-            // User defined error handlers, implementing \Nuwave\Lighthouse\Execution\ErrorHandler
+            // User defined error handlers, implementing \Nuwave\Lighthouse\Execution\ErrorHandler.
             // This allows the user to register multiple handlers and pipe the errors through.
             $handlers = [];
             foreach ($this->configRepository->get('lighthouse.error_handlers', []) as $handlerClass) {
@@ -331,11 +331,10 @@ protected function errorsHandler(): callable
 
     protected function debugFlag(): int
     {
-        // If debugging is set to false globally, do not add GraphQL specific
-        // debugging info either. If it is true, then we fetch the debug
-        // level from the Lighthouse configuration.
         return $this->configRepository->get('app.debug')
+            // If Laravel debugging is enabled, we fetch the debug level from the Lighthouse configuration.
             ? (int) $this->configRepository->get('lighthouse.debug')
+            // If Laravel debugging is disabled, do not add GraphQL specific debugging info either.
             : DebugFlag::NONE;
     }
 

src/Schema/Directives/ComplexityDirective.php

@@ -43,9 +43,7 @@ public function complexityResolver(FieldValue $fieldValue): callable
     /** @param  array<string, mixed>  $args */
     public static function defaultComplexityResolver(int $childrenComplexity, array $args): int
     {
-        /**
-         * Assuming pagination, @see PaginationManipulator::countArgument().
-         */
+        /** Assuming pagination, @see PaginationManipulator::countArgument(). */
         $first = $args['first'] ?? null;
 
         $expectedNumberOfChildren = is_int($first)

src/Support/Contracts/CreatesResponse.php

@@ -7,7 +7,7 @@
 interface CreatesResponse
 {
     /**
-     * Create a HTTP response from the final result.
+     * Create an HTTP response from the final result.
      *
      * @param  array<string, mixed>|array<int, array<string, mixed>>  $result
      */