[K/N] Add a note to Regex documentation about future changes of behavior

This note will allow us to fix https://youtrack.jetbrains.com/issue/KT-58198/Native-Regex-issues in the future.

Co-authored-by: Ilya Gorbunov <Ilya.Gorbunov@jetbrains.com>


Merge-request: KT-MR-11387
Merged-by: Abduqodiri Qurbonzoda <abduqodiri.qurbonzoda@jetbrains.com>

libraries/stdlib/native-wasm/src/kotlin/text/Regex.kt

@@ -79,6 +79,8 @@ public actual operator fun MatchGroupCollection.get(name: String): MatchGroup? {
 /**
  * Represents a compiled regular expression.
  * Provides functions to match strings in text with a pattern, replace the found occurrences and split text around matches.
+ *
+ * Note that in the future, the behavior of regular expression matching and replacement functions can be altered to match JVM implementation behavior where differences exist.
  */
 public actual class Regex internal constructor(internal val nativePattern: Pattern) {