update the info about reactive repositories

Author: gavinking

documentation/src/main/asciidoc/repositories/Reactive.adoc

@@ -3,22 +3,27 @@
 
 Hibernate Data Repositories provides repositories backed by https://hibernate.org/reactive/[Hibernate Reactive] for use in reactive programming.
 The methods of a reactive repository are non-blocking, and so every operation returns a reactive stream.
-This is an extension to the programming model defined by Jakarta Data.
 
 [NOTE]
 ====
-The Jakarta Data specification has not yet defined a way to write repositories for use in reactive programming, but the spec was written to accommodate such extensions, and this capability might be standardized in a future release.
+Jakarta Data 1.0 does not define a way to write repositories for use in reactive programming, but the spec was written to accommodate such extensions.
+This capability is being written into Data 1.1 under the more general category of _asynchronous repositories_.
 ====
 
 In Hibernate Data Repositories we use https://smallrye.io/smallrye-mutiny/[Mutiny] to work with reactive streams.
 
-[WARNING]
+[CAUTION]
 ====
-If and when Jakarta Data _does_ provide standard support for reactive repositories, the functionality will almost certainly be based on Java's `CompletionStage`, and not on Mutiny.
+A future version of Hibernate Data Repositories will also allow the use of `CompletionStage` from `java.util.concurrent`.
+Asynchronous repositories based on Mutiny are unlikely to ever be portable to other implementations of Jakarta Data.
 ====
 
 In our opinion, Mutiny is a _much_ more comfortable API than `CompletionStage`.
 
+[TIP]
+The documentation for Hibernate Reactive contains a https://hibernate.org/reactive/documentation/3.0/reference/html_single/#_apis_for_chaining_reactive_operations[comparison table] that's useful if you're more familiar with `CompletionStage`.
+
+
 === Defining a reactive repository
 
 In the following code example we notice the two requirements for a reactive repository in Hibernate Data Repositories: