diff --git a/topics/basics/basic_action_system.md b/topics/basics/basic_action_system.md
index 50958a2d9..f8eee4fe7 100644
--- a/topics/basics/basic_action_system.md
+++ b/topics/basics/basic_action_system.md
@@ -26,7 +26,9 @@ The [](grouping_action.md) tutorial demonstrates three types of groups that can
 ## Action Implementation
 
 An action is a class derived from the abstract class [`AnAction`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/AnAction.java).
-For actions available during [dumb mode](indexing_and_psi_stubs.md#dumb-mode), extend [`DumbAwareAction`](%gh-ic%/platform/ide-core/src/com/intellij/openapi/project/DumbAwareAction.java).
+For actions available during [dumb mode](indexing_and_psi_stubs.md#dumb-mode), extend [`DumbAwareAction`](%gh-ic%/platform/ide-core/src/com/intellij/openapi/project/DumbAwareAction.java)
+(do not override `AnAction.isDumbAware()` instead).
+
 See also [](#useful-action-base-classes) below.
 
 The IntelliJ Platform calls methods of actions when a user interacts with a menu item or toolbar button.
diff --git a/topics/basics/indexing_and_psi_stubs.md b/topics/basics/indexing_and_psi_stubs.md
index c5a5266a7..d99da5312 100644
--- a/topics/basics/indexing_and_psi_stubs.md
+++ b/topics/basics/indexing_and_psi_stubs.md
@@ -52,7 +52,7 @@ Since 2024.2, this includes also [intentions](code_intentions.md) and [quick-fix
 
 #### Actions
 
-For [](basic_action_system.md) available during Dumb Mode, extend [`DumbAwareAction`](%gh-ic%/platform/ide-core/src/com/intellij/openapi/project/DumbAwareAction.java).
+For [](basic_action_system.md) available during Dumb Mode, extend [`DumbAwareAction`](%gh-ic%/platform/ide-core/src/com/intellij/openapi/project/DumbAwareAction.java) (do not override `AnAction.isDumbAware()` instead).
 
 #### Other API