diff --git a/core/src/main/kotlin/org/jetbrains/jewel/painter/PainterHintsProvider.kt b/core/src/main/kotlin/org/jetbrains/jewel/painter/PainterHintsProvider.kt
index 5cdca4b95c..675118c7c3 100644
--- a/core/src/main/kotlin/org/jetbrains/jewel/painter/PainterHintsProvider.kt
+++ b/core/src/main/kotlin/org/jetbrains/jewel/painter/PainterHintsProvider.kt
@@ -19,13 +19,13 @@ import org.jetbrains.jewel.painter.hints.HiDpi
 interface PainterHintsProvider {
 
     /**
-     * Those hints will be added before the [hints][PainterProvider.getPainter] that passed in [PainterProvider.getPainter].
+     * These hints will be consumed before the [hints] when [PainterProvider.getPainter] is called.
      */
     @Composable
     fun priorityHints(path: String): List<PainterHint> = emptyList()
 
     /**
-     * Those hints will be added after the [hints][PainterProvider.getPainter] that passed in [PainterProvider.getPainter].
+     * These hints will be consumed after the [priorityHints] when [PainterProvider.getPainter] is called.
      */
     @Composable
     fun hints(path: String): List<PainterHint>