diff --git a/platform/lang-impl/src/com/intellij/ide/projectView/ProjectViewNodeDecorator.java b/platform/lang-impl/src/com/intellij/ide/projectView/ProjectViewNodeDecorator.java
index 986d36c92dd5..7a4635ece9bf 100644
--- a/platform/lang-impl/src/com/intellij/ide/projectView/ProjectViewNodeDecorator.java
+++ b/platform/lang-impl/src/com/intellij/ide/projectView/ProjectViewNodeDecorator.java
@@ -21,12 +21,27 @@ import com.intellij.packageDependencies.ui.PackageDependenciesNode;
 import com.intellij.ui.ColoredTreeCellRenderer;
 
 /**
+ * Allows to modify the presentation of project view and package dependencies view nodes.
+ *
  * @author yole
+ * @see com.intellij.ide.projectView.TreeStructureProvider
  */
 public interface ProjectViewNodeDecorator {
   ExtensionPointName<ProjectViewNodeDecorator> EP_NAME = ExtensionPointName.create("com.intellij.projectViewNodeDecorator");
 
+  /**
+   * Modifies the presentation of a project view node.
+   *
+   * @param node the node to modify (use {@link ProjectViewNode#getValue()} to get the object represented by the node).
+   * @param data the current presentation of the node, which you can modify as necessary.
+   */
   void decorate(ProjectViewNode node, PresentationData data);
 
+  /**
+   * Modifies the presentation of a package dependencies view node.
+   *
+   * @param node the node to modify.
+   * @param cellRenderer the current renderer for the node, which you can modify as necessary.
+   */
   void decorate(PackageDependenciesNode node, ColoredTreeCellRenderer cellRenderer);
 }