diff --git a/platform/lang-impl/src/com/intellij/execution/update/RunningApplicationUpdater.java b/platform/lang-impl/src/com/intellij/execution/update/RunningApplicationUpdater.java
index 5b51162c1fb0..ea0f532c6809 100644
--- a/platform/lang-impl/src/com/intellij/execution/update/RunningApplicationUpdater.java
+++ b/platform/lang-impl/src/com/intellij/execution/update/RunningApplicationUpdater.java
@@ -5,6 +5,13 @@ import org.jetbrains.annotations.Nullable;
 
 import javax.swing.*;
 
+/**
+ * Instance of {@link RunningApplicationUpdater} may be provided to {@link UpdateRunningApplicationAction}
+ * by {@link RunningApplicationUpdaterProvider}.
+ * {@link UpdateRunningApplicationAction} will be available for user if at least one updater is provided.
+ * {@link #performUpdate()} will be called on performing the action.
+ * Popup with available updaters will be shown at first if there more then one available updater.
+ */
 public interface RunningApplicationUpdater {
   String getDescription();
 
diff --git a/platform/lang-impl/src/com/intellij/execution/update/RunningApplicationUpdaterProvider.java b/platform/lang-impl/src/com/intellij/execution/update/RunningApplicationUpdaterProvider.java
index 5bf1ece22ec3..954ca8e2d2db 100644
--- a/platform/lang-impl/src/com/intellij/execution/update/RunningApplicationUpdaterProvider.java
+++ b/platform/lang-impl/src/com/intellij/execution/update/RunningApplicationUpdaterProvider.java
@@ -7,6 +7,10 @@ import com.intellij.openapi.project.Project;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+/**
+ * {@link UpdateRunningApplicationAction} is intended to perform an update of running application.
+ * Via implementing this extension it's possible to provide an updater and make the action available for particular running application.
+ */
 public interface RunningApplicationUpdaterProvider {
   ExtensionPointName<RunningApplicationUpdaterProvider> EP_NAME =
     ExtensionPointName.create("com.intellij.runningApplicationUpdaterProvider");