diff --git a/action_basics/README.md b/action_basics/README.md
index ca6057528..7a213f449 100644
--- a/action_basics/README.md
+++ b/action_basics/README.md
@@ -1,16 +1,19 @@
-# Action Sample Project [][docs]
+# Action Basics Sample Project [][docs]
*Reference: [Action System in IntelliJ SDK Docs][docs:actions]*
## Quickstart
-Action Sample Project demonstrates registering actions process in various configurations.
-Each action is an extension of the [`AnAction`][sdk:AnAction] abstract class and brings the possibility of extending IDE with an event performed with the user interaction - i.e., clicking the button, using the keyboard or mouse shortcuts.
-
-Plugin registers the [`PopupDialogAction`][file:PopupDialogAction] action, which provides a popup dialog as a feedback, in three different ways:
+The Action Basics Sample Project demonstrates the process of registering actions in various configurations.
+Each action is an extension of the [`AnAction`][sdk:AnAction] abstract class and brings the possibility of extending the IDE with an event performed with the user interaction - i.e., clicking the button, using the keyboard or mouse shortcuts.
+This Plugin registers the [`PopupDialogAction`][file:PopupDialogAction] action, which provides a popup dialog as a feedback, in three different ways:
- by assigning the keyboard (Ctrl/Cmd+Alt+A, C) and mouse shortcuts (Ctrl/Cmd + Mouse Button 3 + Double Click),
-- by adding action item to the `ToolsMenu` group, available in Tools menu,
-- by adding action item to the `EditorPopupMenu` group, available in Editor's context menu.
+- by adding an action to the `ToolsMenu` directly, and as part of new groups added to the Tools menu,
+- by adding an action to a new group in the `EditorPopupMenu`, which is the Editor's context menu.
+
+Additional features of the plugin:
+- [Using the ``][docs:action-override] element in an `` element is demonstrated in the `plugin.xml` declaration to add the `PopupDialogAction` action directly to the `ToolsMenu`.
+- [Localization of action and group][docs:action-locale] `text` and `description` attributes using a `` is demonstrated in the declaration to add a new group to the `EditorPopupMenu`.
### Actions
@@ -27,6 +30,8 @@ Plugin registers the [`PopupDialogAction`][file:PopupDialogAction] action, which
[docs]: https://www.jetbrains.org/intellij/sdk/docs
[docs:actions]: https://www.jetbrains.org/intellij/sdk/docs/basics/action_system.html
+[docs:action-override]: https://www.jetbrains.org/intellij/sdk/docs/basics/action_system.html#setting-the-override-text-element-for-an-action
+[docs:action-locale]: https://www.jetbrains.org/intellij/sdk/docs/basics/action_system.html#localizing-actions-and-groups
[file:PopupDialogAction]: ./src/main/java/org/intellij/sdk/action/PopupDialogAction.java
[file:CustomDefaultActionGroup]: ./src/main/java/org/intellij/sdk/action/CustomDefaultActionGroup.java
diff --git a/action_basics/src/main/java/org/intellij/sdk/action/CustomDefaultActionGroup.java b/action_basics/src/main/java/org/intellij/sdk/action/CustomDefaultActionGroup.java
index d9c058f62..b50e92be8 100644
--- a/action_basics/src/main/java/org/intellij/sdk/action/CustomDefaultActionGroup.java
+++ b/action_basics/src/main/java/org/intellij/sdk/action/CustomDefaultActionGroup.java
@@ -26,7 +26,7 @@ public class CustomDefaultActionGroup extends DefaultActionGroup {
// Enable/disable depending on whether user is editing
Editor editor = event.getData(CommonDataKeys.EDITOR);
event.getPresentation().setEnabled(editor != null);
- // Take this opportunity to set an icon for the menu entry.
+ // Take this opportunity to set an icon for the group.
event.getPresentation().setIcon(SdkIcons.Sdk_default_icon);
}
diff --git a/action_basics/src/main/resources/META-INF/plugin.xml b/action_basics/src/main/resources/META-INF/plugin.xml
index 173770fc4..567daa508 100644
--- a/action_basics/src/main/resources/META-INF/plugin.xml
+++ b/action_basics/src/main/resources/META-INF/plugin.xml
@@ -30,46 +30,61 @@
IntelliJ Platform SDK
+
+ messages.BasicActionsBundle
+
-
+
-
+ class="org.intellij.sdk.action.CustomDefaultActionGroup"
+ popup="true">
-
+