diff --git a/platform/core-api/src/com/intellij/psi/PsiReferencesWrapper.java b/platform/core-api/src/com/intellij/psi/PsiReferencesWrapper.java
index a7c12ca7a126..03d0d6c1f3ad 100644
--- a/platform/core-api/src/com/intellij/psi/PsiReferencesWrapper.java
+++ b/platform/core-api/src/com/intellij/psi/PsiReferencesWrapper.java
@@ -7,6 +7,11 @@ import org.jetbrains.annotations.Unmodifiable;
 
 import java.util.List;
 
+/**
+ * An interface for {@link PsiReference}-es that wraps another (multiple) references.
+ * Is useful for cases when references need a complicated priority or range computations and/or lazy reference computation.
+ * But in general wrapping references should not be considered as a good practice and should be used only in interaction with legacy code.
+ */
 @ApiStatus.Experimental
 public interface PsiReferencesWrapper {