Explain status codes in comments

Author: alexislefebvre

Controller/AbstractController.php

@@ -124,6 +124,8 @@ protected function forward(string $controller, array $path = [], array $query =
 
     /**
      * Returns a RedirectResponse to the given URL.
+     *
+     * @param int $status The HTTP status code (302 "Found" by default)
      */
     protected function redirect(string $url, int $status = 302): RedirectResponse
     {
@@ -132,6 +134,8 @@ protected function redirect(string $url, int $status = 302): RedirectResponse
 
     /**
      * Returns a RedirectResponse to the given route with the given parameters.
+     *
+     * @param int $status The HTTP status code (302 "Found" by default)
      */
     protected function redirectToRoute(string $route, array $parameters = [], int $status = 302): RedirectResponse
     {
@@ -140,6 +144,8 @@ protected function redirectToRoute(string $route, array $parameters = [], int $s
 
     /**
      * Returns a JsonResponse that uses the serializer component if enabled, or json_encode.
+     *
+     * @param int $status The HTTP status code (200 "OK" by default)
      */
     protected function json(mixed $data, int $status = 200, array $headers = [], array $context = []): JsonResponse
     {

Controller/TemplateController.php

@@ -38,7 +38,7 @@ public function __construct(Environment $twig = null)
      * @param int|null  $sharedAge  Max age for shared (proxy) caching
      * @param bool|null $private    Whether or not caching should apply for client caches only
      * @param array     $context    The context (arguments) of the template
-     * @param int       $statusCode The HTTP status code to return with the response. Defaults to 200
+     * @param int       $statusCode The HTTP status code to return with the response (200 "OK" by default)
      */
     public function templateAction(string $template, int $maxAge = null, int $sharedAge = null, bool $private = null, array $context = [], int $statusCode = 200): Response
     {
@@ -65,6 +65,9 @@ public function templateAction(string $template, int $maxAge = null, int $shared
         return $response;
     }
 
+    /**
+     * @param int $statusCode The HTTP status code (200 "OK" by default)
+     */
     public function __invoke(string $template, int $maxAge = null, int $sharedAge = null, bool $private = null, array $context = [], int $statusCode = 200): Response
     {
         return $this->templateAction($template, $maxAge, $sharedAge, $private, $context, $statusCode);