diff --git a/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/EssentialContributor.java b/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/EssentialContributor.java
index f90896e6f732..f574585f4148 100644
--- a/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/EssentialContributor.java
+++ b/platform/lang-api/src/com/intellij/ide/actions/searcheverywhere/EssentialContributor.java
@@ -11,6 +11,12 @@ import org.jetbrains.annotations.Nullable;
  */
 public interface EssentialContributor {
 
+  /**
+   * Defines whether the contributor should be considered essential by default.
+   * This behavior may be altered by a machine learning model (the non-default behavior).
+   *
+   * @see EssentialContributor#checkEssential(SearchEverywhereContributor)
+   */
   default boolean isEssentialByDefault() {
     return true;
   }