docs: Address review comments

docs/source/clientrpc.rst

@@ -15,6 +15,8 @@ detail on how to use this is provided in the docs for the proxy method.
    resources. When you're done with it, cast it to ``Closeable`` or ``AutoCloseable`` and close it. Don't create
    one for every call you make - create a proxy and reuse it.
 
+For a brief tutorial on how one can use the RPC API see :doc:`tutorial-clientrpc-api`.
+
 Observables
 -----------
 

docs/source/example-code/src/main/kotlin/com/r3corda/docs/ClientRpcTutorial.kt

@@ -2,9 +2,11 @@ package com.r3corda.docs
 
 import com.google.common.net.HostAndPort
 import com.r3corda.client.CordaRPCClient
+import com.r3corda.core.transactions.SignedTransaction
 import org.graphstream.graph.Edge
 import org.graphstream.graph.Node
 import org.graphstream.graph.implementations.SingleGraph
+import rx.Observable
 import java.nio.file.Paths
 import java.util.concurrent.CompletableFuture
 
@@ -34,7 +36,7 @@ fun main(args: Array<String>) {
     // END 2
 
     // START 3
-    val (transactions, futureTransactions) = proxy.verifiedTransactions()
+    val (transactions: List<SignedTransaction>, futureTransactions: Observable<SignedTransaction>) = proxy.verifiedTransactions()
     // END 3
 
     // START 4

docs/source/tutorial-clientrpc-api.rst

@@ -4,7 +4,8 @@ Client RPC API
 ==============
 
 In this tutorial we will build a simple command line utility that connects to a node and dumps the transaction graph to
-the standard output. We will then put some simple visualisation on top.
+the standard output. We will then put some simple visualisation on top. For an explanation on how the RPC works see
+:doc:`clientrpc`.
 
 We start off by connecting to the node itself. For the purposes of the tutorial we will run the Trader demo on some
 local port and connect to the Buyer side. We will pass in the address as a command line argument. To connect to the node