fixes docs

Signed-off-by: Oleh Dokuka <[email protected]>

Author: OlegDokuka

rsocket-core/src/main/java/io/rsocket/RSocketFactory.java

@@ -259,8 +259,8 @@ public ClientRSocketFactory singleSubscriberRequester() {
      *
      * }</pre>
      *
-     * Apart of the shared behavior, if the connection is lost, the same {@code Mono<RSocket>} instance
-     * will transparently re-establish the connection for subsequent subscribers.<br>
+     * Apart of the shared behavior, if the connection is lost, the same {@code Mono<RSocket>}
+     * instance will transparently re-establish the connection for subsequent subscribers.<br>
      * For example:
      *
      * <pre>{@code
@@ -290,6 +290,24 @@ public ClientRSocketFactory singleSubscriberRequester() {
      *
      * }</pre>
      *
+     * <b>Note,</b> having reconnect() enabled does not eliminate the need to accompany each
+     * individual request with the corresponding retry logic. For example:
+     *
+     * <pre>{@code
+     * Mono<RSocket> sharedRSocketMono =
+     *   RSocketFactory
+     *                .connect()
+     *                .singleSubscriberRequester()
+     *                .reconnect(Retry.fixedDelay(3, Duration.ofSeconds(1)))
+     *                .transport(transport)
+     *                .start();
+     *
+     *  sharedRSocket.flatMap(rSocket -> rSocket.requestResponse(...))
+     *               .retryWhen(ownRetry)
+     *               .subscribe()
+     *
+     * }</pre>
+     *
      * @param retrySpec a retry factory applied for {@link Mono#retryWhen(Retry)}
      * @return a shared instance of {@code Mono<RSocket>}.
      */