chore: Fix some controllers comments

Author: marienfressinaud

src/controllers/Discovery.php

@@ -17,6 +17,7 @@ class Discovery extends BaseController
      * Show the discovery page
      *
      * @response 200
+     *     On success.
      */
     public function show(Request $request): Response
     {

src/controllers/Pages.php

@@ -17,10 +17,10 @@ class Pages extends BaseController
     /**
      * Show the home page.
      *
-     * @response 302 /news if connected
-     * @response 302 /login else
-     *
-     * @return \Minz\Response
+     * @response 302 /login
+     *     If the user is not connected.
+     * @response 302 /news
+     *     If the user is connected.
      */
     public function home(): Response
     {
@@ -35,11 +35,9 @@ public function home(): Response
      * Show the terms of service.
      *
      * @response 404
-     *     if the policies/legals.html file doesn’t exist
+     *     If the policies/legals.html file doesn’t exist.
      * @response 200
-     *     on success
-     *
-     * @return \Minz\Response
+     *     On success.
      */
     public function terms(): Response
     {
@@ -59,6 +57,7 @@ public function terms(): Response
      * Show the addons page.
      *
      * @response 200
+     *     On success.
      */
     public function addons(Request $request): Response
     {
@@ -69,6 +68,7 @@ public function addons(Request $request): Response
      * Show the about page.
      *
      * @response 200
+     *     On success.
      */
     public function about(): Response
     {
@@ -81,6 +81,7 @@ public function about(): Response
      * Show the robots page.
      *
      * @response 200
+     *     On success.
      */
     public function robots(): Response
     {
@@ -93,6 +94,7 @@ public function robots(): Response
      * Show the webmanifest page.
      *
      * @response 200
+     *     On success.
      */
     public function webmanifest(): Response
     {

src/controllers/Sessions.php

@@ -25,6 +25,7 @@ class Sessions extends BaseController
      * @response 302 :redirect_to
      *     If the user is already connected.
      * @response 200
+     *     On success.
      */
     public function new(Request $request): Response
     {

src/controllers/Showcases.php

@@ -19,8 +19,10 @@ class Showcases extends BaseController
      *
      * @request_param string id
      *
-     * @response 404 If the id doesn’t exist
-     * @response 200 On success
+     * @response 404
+     *     If the id doesn’t exist.
+     * @response 200
+     *     On success.
      */
     public function show(Request $request): Response
     {

src/controllers/WellKnown.php

@@ -11,13 +11,12 @@
 class WellKnown extends BaseController
 {
     /**
-     * Redirect to the change password page
+     * Redirect to the change password page.
      *
      * @see https://w3c.github.io/webappsec-change-password-url/
      *
      * @response 302 /my/security
-     *
-     * @return \Minz\Response
+     *     On success.
      */
     public function changePassword(): Response
     {