From ce7735e2eeb75c151fd3c66a9f365ace7e3212ea Mon Sep 17 00:00:00 2001
From: Adam Malek <adam.malek@jetbrains.com>
Date: Wed, 16 Jul 2025 07:34:26 +0000
Subject: [PATCH] Add doc

(cherry picked from commit dd94863481555c22666a50a36b12ba2f9ae3798a)

IJ-MR-168243

GitOrigin-RevId: e681c5ed54c0cdf76460fd75aa3e76a502a59619
---
 .../ide/actions/searcheverywhere/EssentialContributor.java  | 6 ++++++
 1 file changed, 6 insertions(+)

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;
   }