Explain used dependency versions

examples/gradle.properties

@@ -15,10 +15,15 @@
 #
 
 #https://github.com/quarkusio/quarkus
+# Can be upgraded freely and probably should be
 quarkusVersion=3.15.1
+
 #https://github.com/JetBrains/kotlin
+# Needs to match Quarkus Kotlin version for compatibility
 kotlinVersion=2.0.10
+
 #https://github.com/google/ksp
+# Latest version matching the above Kotlin version
 kspVersion=2.0.10-1.0.24
 
 #https://github.com/Kotlin/kotlinx-kover

gradle.properties

@@ -14,17 +14,30 @@
 # limitations under the License.
 #
 
-#https://github.com/quarkusio/quarkus
+#https://github.com/quarkusio/quarkus Pinned, do not change
+# Minimum, because of https://osv.dev/vulnerability/GHSA-f8h5-v2vg-46rr
+# Does not need to be upgraded since we only use the Panache API
+# This API is backwards compatible so upgrading would be pointless
 quarkusVersion=3.9.2
-#https://github.com/JetBrains/kotlin
+
+#https://github.com/JetBrains/kotlin Pinned, do not change
+# Needs to match Quarkus Kotlin version for compatibility
 kotlinVersion=1.9.23
-#https://github.com/google/ksp
+
+#https://github.com/google/ksp Pinned, do not change
+# Latest version matching the above Kotlin version
 kspVersion=1.9.23-1.0.20
-#https://github.com/square/kotlinpoet
+
+#https://github.com/square/kotlinpoet Pinned, do not change
+# Latest version supporting the above Kotlin version
 kotlinPoetVersion=1.16.0
-#https://github.com/mockk/mockk
+
+#https://github.com/mockk/mockk Pinned, do not change
+# Latest version supporting the above Kotlin version
 mockkVersion=1.13.11
+
 #https://github.com/tschuchortdev/kotlin-compile-testing
+# TODO might be upgradable, test implementation needed to be sure
 compileTestingVersion=1.5.0
 
 #https://github.com/Kotlin/kotlinx-kover