diff --git a/java/java-psi-api/src/com/intellij/psi/augment/PsiAugmentProvider.java b/java/java-psi-api/src/com/intellij/psi/augment/PsiAugmentProvider.java
index 0d2fa85b9671..d2fc5de10594 100644
--- a/java/java-psi-api/src/com/intellij/psi/augment/PsiAugmentProvider.java
+++ b/java/java-psi-api/src/com/intellij/psi/augment/PsiAugmentProvider.java
@@ -38,6 +38,7 @@ import java.util.List;
 /**
  * Some code is not what it seems to be!
  * This extension allows plugins <strike>augment a reality</strike> alter a behavior of Java PSI elements.
+ * To get an insight of how the extension may be used see {@code PsiAugmentProviderTest}.
  * <p>
  * N.B. during indexing, only {@link DumbAware} providers are run.
  */