diff --git a/akka-samples/akka-sample-remote/README.rst b/akka-samples/akka-sample-remote/README.rst
index 0732c33327..5f9a9fb6c6 100644
--- a/akka-samples/akka-sample-remote/README.rst
+++ b/akka-samples/akka-sample-remote/README.rst
@@ -11,7 +11,12 @@ The Sample Explained
 
 In order to showcase the remote capabilities of Akka 2.0 we thought a remote calculator could do the trick.
 
+There are two implementations of the sample; one in Scala and one in Java.
+The explanation below is for Scala, but everything is similar in Java except that the class names begin with a ``J``,
+e.g. ``JCalcApp`` instead of ``CalcApp``, and that the Java classes reside in another package structure.
+
 There are three actor systems used in the sample:
+
 * CalculatorApplication : the actor system performing the number crunching
 * LookupApplication     : illustrates how to look up an actor on a remote node and and how communicate with that actor
 * CreationApplication   : illustrates how to create an actor on a remote node and how to communicate with that actor
@@ -134,5 +139,5 @@ The sample application is just that, i.e. a sample. Parts of it are not the way
 Some improvements are to remove all hard coded addresses from the code as they reduce the flexibility of how and
 where the application can be run. We leave this to the astute reader to refine the sample into a real-world app.
 
-[akka]: http://akka.io
-[sbt]: http://code.google.com/p/simple-build-tool/
+* `Akka <http://akka.io/>`_
+* `SBT <http://https://github.com/harrah/xsbt/wiki/>`_