docs: apply suggestions from code review

Co-authored-by: kenjis <kenji.uui@gmail.com>

Author: datamweb

UPGRADING.md

@@ -29,16 +29,17 @@ following steps will be done.
 
 The following items have been added. Copy the properties in **src/Config/Auth.php**.
 
-- `$permission_denied` and `$group_denied` are added to `Config\Auth::$redirects`.
+- `permission_denied` and `group_denied` are added to `Config\Auth::$redirects`.
 - `permissionDeniedRedirect()` and `groupDeniedRedirect()` are added.
 
 #### Fix Custom Filter If extends `AbstractAuthFilter`
-If you have written a custom filter that extends `AbstractAuthFilter`. Now you need to add and implement method `redirectToDeniedUrl()` to your custom filter.
+
+If you have written a custom filter that extends `AbstractAuthFilter`, now you need to add and implement the `redirectToDeniedUrl()` method to your custom filter.
 The following example is related to the above explanation for **group** filter.
+
 ```php
 /**
- * If there is no necessary access to the group,
- * it will redirect the user to the set URL with an error message.
+ * If the user does not belong to the group, redirect to the configured URL with an error message.
  */
 protected function redirectToDeniedUrl(): RedirectResponse
 {

src/Filters/AbstractAuthFilter.php

@@ -55,7 +55,14 @@ public function after(RequestInterface $request, ResponseInterface $response, $a
         // Nothing required
     }
 
+    /**
+     * Ensures the user is logged in and has one or more
+     * of the permissions as specified in the filter.
+     */
     abstract protected function isAuthorized(array $arguments): bool;
 
+    /**
+     * Returns redirect response when the user does not have access authorizations.
+     */
     abstract protected function redirectToDeniedUrl(): RedirectResponse;
 }

src/Filters/GroupFilter.php

@@ -21,8 +21,7 @@ protected function isAuthorized(array $arguments): bool
     }
 
     /**
-     * If there is no necessary access to the group,
-     * it will redirect the user to the set URL with an error message.
+     * If the user does not belong to the group, redirect to the configured URL with an error message.
      */
     protected function redirectToDeniedUrl(): RedirectResponse
     {

src/Filters/PermissionFilter.php

@@ -27,8 +27,7 @@ protected function isAuthorized(array $arguments): bool
     }
 
     /**
-     * If there is no necessary access to the permission,
-     * it will redirect the user to the set URL with an error message.
+     * If the user does not have the permission, redirect to the configured URL with an error message.
      */
     protected function redirectToDeniedUrl(): RedirectResponse
     {