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 675118c7c..fb6b363ee 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 {
 
     /**
-     * These hints will be consumed before the [hints] when [PainterProvider.getPainter] is called.
+     * These hints will be consumed before the hints which are passed as a parameter to [PainterProvider.getPainter].
      */
     @Composable
     fun priorityHints(path: String): List<PainterHint> = emptyList()
 
     /**
-     * These hints will be consumed after the [priorityHints] when [PainterProvider.getPainter] is called.
+     * These hints will be consumed after the hints which are passed as a parameter to [PainterProvider.getPainter].
      */
     @Composable
     fun hints(path: String): List<PainterHint>