Fix more API docs

Author: cllns

lib/hanami/action.rb

@@ -364,8 +364,8 @@ def handle(request, response)
     #
     # @since 0.2.0
     #
-    # @see Hanami::Action::Throwable#handle_exception
-    # @see Hanami::Http::Status:ALL
+    # @see Hanami::Action.handle_exception
+    # @see https://rubydoc.info/github/rack/rack/Rack/Utils
     #
     # @example Basic usage
     #   require "hanami/controller"
@@ -528,8 +528,6 @@ def _run_after_callbacks(*args)
     #
     # @since 0.5.0
     #
-    # @see Hanami::Action#_requires_no_body?
-    #
     # @example
     #   require "hanami/controller"
     #

lib/hanami/action/cache.rb

@@ -5,6 +5,7 @@ class Action
     # Cache type API
     #
     # @since 0.3.0
+    # @api private
     #
     # @see Hanami::Action::Response#cache_control
     # @see Hanami::Action::Response#expires

lib/hanami/action/config.rb

@@ -137,15 +137,13 @@ def format(*formats)
 
       # @!attribute [rw] root_directory
       #
-      #   Sets the the for the public directory, which is used for file downloads.
+      #   Sets the the root directory for the public directory, which is used for file downloads.
       #   This must be an existent directory.
       #
       #   Defaults to the current working directory.
       #
       #   @return [String] the directory path
       #
-      #   @api private
-      #
       #   @since 1.0.0
 
       # @!attribute [rw] public_directory

lib/hanami/action/cookie_jar.rb

@@ -11,7 +11,7 @@ class Action
     #
     # @since 0.1.0
     #
-    # @see Hanami::Action::Cookies#cookies
+    # @see Hanami::Action::Response#cookies
     class CookieJar
       # @since 0.4.5
       # @api private

lib/hanami/action/cookies.rb

@@ -4,7 +4,8 @@ module Hanami
   class Action
     # Cookies API
     #
-    # This module isn't included by default.
+    # If you want cookies in your actions then include this module.
+    # It's not included by default.
     #
     # @since 0.1.0
     #

lib/hanami/action/csrf_protection.rb

@@ -29,8 +29,8 @@ class Action
     #
     # @since 0.4.0
     #
-    # @see https://www.owasp.org/index.php/Cross-Site_Request_Forgery_%28CSRF%29
-    # @see https://www.owasp.org/index.php/Cross-Site_Request_Forgery_(CSRF)_Prevention_Cheat_Sheet
+    # @see https://owasp.org/www-community/attacks/csrf
+    # @see https://cheatsheetseries.owasp.org/cheatsheets/Cross-Site_Request_Forgery_Prevention_Cheat_Sheet.html
     #
     # @example Custom Handling
     #   module Web::Controllers::Books