Merge pull request #769 from modelix/docs/clarify-intended-finalization

docs: clarify intendedFinalization in UnstableModelixFeature

Author: languitar

kotlin-utils/src/commonMain/kotlin/org/modelix/kotlin/utils/UnstableModelixFeature.kt

@@ -20,7 +20,10 @@ package org.modelix.kotlin.utils
  * Marks an API as unstable.
  *
  * @param reason Describes why the feature is experimental.
- * @param intendedFinalization Describes when this API is intended to be finalized or removed.
+ * @param intendedFinalization Describes when this API is intended to be
+ *        finalized or removed. This field is intended to capture a condition and
+ *        progress metadata such as a ticket number describing when the feature
+ *        becomes ready. It's not meant to capture a date or specific release.
  */
 @RequiresOptIn(message = "This API is experimental. It may be changed in the future without notice.")
 @Retention(AnnotationRetention.BINARY)