I created this ticket as a follow-up discussion in #engineering to make sure we will work on some of the points that were raised.
The following docs changes to be made in https://docs.corda.net/head/clientrpc.html#enabling-graceful-reconnection:
elaborate on what is considered an in-flight request
make clear the distinction between rpc calls with side-effects (flow invocations) and rpc calls without side-effects) and what's the behaviour of the client (exception VS transparent retry-ing).
For the avoidance of doubt, I'd also suggest doing one more test with the NodeExplorer to make sure there's no risk of a duplicate flow invocation & ideally enhancing the test `CordaRPCClientReconnectionTest` to capture this scenario.