diff --git a/lib/modules/manager/kotlin-script/readme.md b/lib/modules/manager/kotlin-script/readme.md
index e227cd5a830346fcc599cd7a681761fd25666062..e422ed4ba3436c52f933a842e97d5160089a7737 100644
--- a/lib/modules/manager/kotlin-script/readme.md
+++ b/lib/modules/manager/kotlin-script/readme.md
@@ -1,11 +1,6 @@
----
-title: Kotlin Script dependency versions
-description: Kotlin Script dependency versions support in Renovate
----
-
 Renovate supports upgrading dependencies in [Kotlin Script](https://github.com/Kotlin/KEEP/blob/master/proposals/scripting-support.md) files.
-These are self-contained scripts where one can write Kotlin code with JVM backend, and compilation happens when the
-scripts are ran. For example:
+Read the [Kotlin Script docs](https://kotlinlang.org/docs/custom-script-deps-tutorial.html) to learn more.
+For example:
 
 ```kotlin
 #!/usr/bin/env kotlin
@@ -19,9 +14,10 @@ println("Hello world!")
 // ...
 ```
 
-By default, Renovate scans files only with `.main.kts` extension and not `.kts`, to avoid ambiguity with Gradle config
-files that have `.gradle.kts` extension. As there are cases where just `.kts` extension or no extension is used,
-Renovate can be [configured](https://docs.renovatebot.com/configuration-options/) to scan also these:
+By default, Renovate only scans files with the `.main.kts` extension and not `.kts`.
+This way Renovate avoids ambiguity with Gradle config files that use the `.gradle.kts` extension.
+
+If you want to manage other Kotlin Script files, you may use the `fileMatch` config option to let Renovate update these files:
 
 ```json
 {