diff --git a/platform/lvcs-impl/src/com/intellij/history/core/LocalHistoryFacade.kt b/platform/lvcs-impl/src/com/intellij/history/core/LocalHistoryFacade.kt
index 61e5ef6953a6..f43461c9eeda 100644
--- a/platform/lvcs-impl/src/com/intellij/history/core/LocalHistoryFacade.kt
+++ b/platform/lvcs-impl/src/com/intellij/history/core/LocalHistoryFacade.kt
@@ -23,6 +23,13 @@ import org.jetbrains.annotations.ApiStatus
 import org.jetbrains.annotations.TestOnly
 import java.nio.file.Path
 
+/**
+ * Facade for managing local history operations.
+ *
+ * Provides methods for managing [com.intellij.history.core.changes.Change].
+ * E.g., modifying content, renaming, changing read-only status, moving, and deleting.
+ * It also allows adding and managing system and user labels and aggregate changes by [ActivityId]
+ */
 open class LocalHistoryFacade internal constructor() {
 
   internal val storageDir: Path
diff --git a/platform/lvcs-impl/src/com/intellij/history/integration/LocalHistoryEx.kt b/platform/lvcs-impl/src/com/intellij/history/integration/LocalHistoryEx.kt
index cc3acb640a2e..3d9a31aecded 100644
--- a/platform/lvcs-impl/src/com/intellij/history/integration/LocalHistoryEx.kt
+++ b/platform/lvcs-impl/src/com/intellij/history/integration/LocalHistoryEx.kt
@@ -5,6 +5,12 @@ import com.intellij.history.LocalHistory
 import com.intellij.history.core.LocalHistoryFacade
 import com.intellij.openapi.Disposable
 
+/**
+ * Provides API access to [LocalHistoryImpl]
+ */
 abstract class LocalHistoryEx : LocalHistory(), Disposable {
+  /**
+   * return null if [LocalHistoryImpl] disabled or not initialized
+   */
   abstract val facade: LocalHistoryFacade?
 }