diff --git a/build.sh b/build.sh
index b721811..51929f5 100755
--- a/build.sh
+++ b/build.sh
@@ -2,7 +2,7 @@
 
 # Building Jace requies:
 #
-#   * maven
+#   * Maven
 #   * Java 1.8
 #
 # On OSX the easiest way to install Maven is to use brew
@@ -14,10 +14,15 @@
 # ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.3:compile (default-compile) on project jace: Fatal error compiling: invalid target release: 1.8 -> [Help 1]
 # org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.3:compile (default-compile) on project jace: Fatal error compiling
 #
-# Cause: You probably have Java 1.8 installed but Maven is (trying to) use Java 1.7
+# Cause: You probably have the Java 1.8 RUNTIME installed but Maven is (trying to) use the Java 1.7 COMPILER.
 #  OR  : You probably have Java 1.7 installed but Maven is (trying to) use Java 1.8
 # Reference: http://stackoverflow.com/questions/24705877/cant-get-maven-to-recognize-java-1-8
 #
+# Here is some information to clear up the confusion about Java:
+#
+#    The JRE (runtime) is needed to RUN Java programs.
+#    The JDK (compiler) is needed to COMPILTE Java programs.
+#
 # Solution:
 #
 # 1. Install Java 1.8
@@ -28,11 +33,36 @@
 #
 #   mvn -version
 #
-# Next, check which version of Java is:
+# Next, check which version of the Java RUNTIME is installed:
 #
 #   java -version
 #
-# Verify what JAVA_HOME is:
+# You should see something like this:
+#
+#       java version "1.8.0_66"
+#       Java(TM) SE Runtime Environment (build 1.8.0_66-b17)
+#
+# To check which version of the Java COMPILER is installed:
+#
+#   javac -version
+#
+# If you see something like this:
+#
+#      javac 1.7.0_75
+#
+# Then you will need to install the Java 1.8 JDK via:
+# http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
+#
+# To download from the command line:
+
+#   For OSX
+#     curl -L -O -H "Cookie: oraclelicense=accept-securebackup-cookie" -k "https://edelivery.oracle.com/otn-pub/java/jdk/8u66-b17/jdk-8u66-macosx-x64.dmg"
+#     open jdk-8u66-macosx-x64.dmg
+#
+#   For Linux
+#     curl -L -O -H "Cookie: oraclelicense=accept-securebackup-cookie" -k "https://edelivery.oracle.com/otn-pub/java/jdk/8u20-b26/jdk-8u20-linux-i586.tar.gz"
+#
+# lastly, verify what JAVA_HOME is:
 #
 #   echo ${JAVA_HOME}
 #