diff --git a/docs/3.0/customizable-controls.md b/docs/3.0/customizable-controls.md
index 4be45b42..66780736 100644
--- a/docs/3.0/customizable-controls.md
+++ b/docs/3.0/customizable-controls.md
@@ -201,7 +201,8 @@ action Avo::Actions::PublishPost, color: :fuchsia, icon: "heroicons/outline/eye"
 
 :::
 
-:::warning
+:::warning WARNING (**NOT** applicable for versions greater than <Version version="3.10.7" />)
+
 When you use the `action` helper in any customizable block it will act only as a shortcut to display the action button, it will not also register it to the resource.
 
 You must manually register it with the `action` declaration.
diff --git a/docs/3.0/upgrade.md b/docs/3.0/upgrade.md
index 98ed97d8..21346f40 100644
--- a/docs/3.0/upgrade.md
+++ b/docs/3.0/upgrade.md
@@ -13,6 +13,51 @@ In versions lower than <Version version="3.10.6" />, boolean fields with a `nil`
 <!-- ## Rails 8 support -->
 
 <!-- TODO: add ransack custom repo mention here -->
+
+## Upgrade from 3.10 to 3.11
+
+### Actions no longer need to be registered inside actions method
+
+Actions inside customizable blocks no longer need to be declared in the `actions` method.
+
+```ruby
+# Before
+
+class Avo::Resources::Fish < Avo::BaseResource
+  self.title = :name
+
+  self.show_controls = -> do
+    # In order to use it here
+    action Avo::Actions::ReleaseFish, style: :primary, color: :fuchsia, arguments: {
+      action_on_show_controls: "Will use this arguments"
+    }
+  end
+
+  # 👇 Also declare it here 👇
+  def actions
+    action Avo::Actions::ReleaseFish, style: :primary, color: :fuchsia, arguments: {
+      action_on_show_controls: "Will use this arguments"
+    }
+  end
+end
+
+# After
+
+class Avo::Resources::Fish < Avo::BaseResource
+  self.title = :name
+
+  self.show_controls = -> do
+    # In order to use it here
+    action Avo::Actions::ReleaseFish, style: :primary, color: :fuchsia, arguments: {
+      action_on_show_controls: "Will use this arguments"
+    }
+  end
+
+  # 👇 No need to declare it here 👇
+  def actions
+  end
+end
+```
 ## Upgrade from 3.9.2 to 3.10
 Deprecated [`fetch_labels`](fields/tags#fetch_labels) option in favor of [`format_using`](fields/tags#format_using) on tags field.