diff --git a/core/src/main/kotlin/org/jetbrains/jewel/painter/PainterProvider.kt b/core/src/main/kotlin/org/jetbrains/jewel/painter/PainterProvider.kt
index f5b531e72..f14427537 100644
--- a/core/src/main/kotlin/org/jetbrains/jewel/painter/PainterProvider.kt
+++ b/core/src/main/kotlin/org/jetbrains/jewel/painter/PainterProvider.kt
@@ -6,10 +6,10 @@ import androidx.compose.runtime.State
 import androidx.compose.ui.graphics.painter.Painter
 
 /**
- * Provide [Painter] by specified [PainterHint], implementations should handle
- * all [PainterHint] correctly, at now, it only need to call [PainterPathHint.patch] and
- * [PainterSvgPatchHint.patch] correctly.
- * Also [PainterProvider] should hold the resource path and [ClassLoader] references.
+ * Implementations of this interface should handle the passed [PainterHint]s correctly.
+ * For now, this means calling [PainterPathHint.patch] and [PainterSvgPatchHint.patch].
+ * Most likely, a [PainterProvider] should also hold the resource path and [ClassLoader]
+ * references.
  */
 @Immutable
 interface PainterProvider {