diff --git a/docs/source/clientrpc.rst b/docs/source/clientrpc.rst
index b691610450..528c8d5ba7 100644
--- a/docs/source/clientrpc.rst
+++ b/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
 -----------
 
diff --git a/docs/source/example-code/src/main/kotlin/com/r3corda/docs/ClientRpcTutorial.kt b/docs/source/example-code/src/main/kotlin/com/r3corda/docs/ClientRpcTutorial.kt
index 44ffdc4144..aa95e319cd 100644
--- a/docs/source/example-code/src/main/kotlin/com/r3corda/docs/ClientRpcTutorial.kt
+++ b/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
diff --git a/docs/source/tutorial-clientrpc-api.rst b/docs/source/tutorial-clientrpc-api.rst
index 5f19b7f635..1ba8709b0e 100644
--- a/docs/source/tutorial-clientrpc-api.rst
+++ b/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