diff --git a/platform/lang-api/src/com/intellij/lang/documentation/DocumentationProvider.java b/platform/lang-api/src/com/intellij/lang/documentation/DocumentationProvider.java
index b889b30f7aff..eacdb5538eb4 100644
--- a/platform/lang-api/src/com/intellij/lang/documentation/DocumentationProvider.java
+++ b/platform/lang-api/src/com/intellij/lang/documentation/DocumentationProvider.java
@@ -29,6 +29,9 @@ import java.util.List;
  */
 public interface DocumentationProvider {
 
+  /**
+   * Please use {@link com.intellij.lang.LanguageDocumentation} instead of this for language-specific documentation
+   */
   ExtensionPointName<DocumentationProvider> EP_NAME = ExtensionPointName.create("com.intellij.documentationProvider");
 
   @Nullable