Update doc blocks for all app/

app/Http/Controllers/Auth/LoginController.php

@@ -83,7 +83,7 @@ class LoginController extends Controller
      * Handle a login request to the application.
      *
      * @param  \Illuminate\Http\Request  $request
-     * @return \Illuminate\Http\Response
+     * @return \Illuminate\Http\Response|\Illuminate\Response\RedirectResponse
      */
     public function login(Request $request)
     {
@@ -126,6 +126,12 @@ class LoginController extends Controller
         }
     }
 
+    /**
+     * Handle a TOTP implementation page.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return \Illuminate\Http\RedirectResponse|\Illuminate\View\View
+     */
     public function totp(Request $request)
     {
         $verifyKey = $request->session()->get('authentication_token');
@@ -140,6 +146,12 @@ class LoginController extends Controller
         ]);
     }
 
+    /**
+     * Handle a TOTP input.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return \Illuminate\Http\RedirectResponse
+     */
     public function totpCheckpoint(Request $request)
     {
         $G2FA = new Google2FA();

app/Http/Controllers/Auth/ResetPasswordController.php

@@ -21,6 +21,11 @@ class ResetPasswordController extends Controller
 
     use ResetsPasswords;
 
+    /**
+     * The URL to redirect users to after password reset.
+     *
+     * @var string
+     */
     public $redirectTo = '/';
 
     /**
@@ -33,6 +38,11 @@ class ResetPasswordController extends Controller
         $this->middleware('guest');
     }
 
+    /**
+     * Return the rules used when validating password reset.
+     *
+     * @return array
+     */
     protected function rules()
     {
         return [