diff --git a/.bazelrc b/.bazelrc
index 548a092..64c7384 100644
--- a/.bazelrc
+++ b/.bazelrc
@@ -1,5 +1,18 @@
+# By default, we build and run ONOS using the Bazel-provided remote JDK. The
+# specific JDK version is defined in tools/build/jdk/BUILD.
+#
+# If you prefer to use your locally installed JDK, replace the --javabase and
+# --host_javabase arguments with the following lines. ABSOLUTE_JAVABASE should
+# point to the "JAVA_HOME" of your JDK.
+#
+# build --javabase=@bazel_tools//tools/jdk:absolute_javabase
+# build --host_javabase=@bazel_tools//tools/jdk:absolute_javabase
+# build --define=ABSOLUTE_JAVABASE=<path/to/jdk>
+# build --define=RUN_WITH_ABSOLUTE_JAVABASE=true
+
 build --javabase=@org_onosproject_onos//tools/build/jdk:default_jdk
 build --host_javabase=@org_onosproject_onos//tools/build/jdk:default_jdk
+
 build --java_toolchain=@org_onosproject_onos//tools/build/jdk:default_toolchain
 build --host_java_toolchain=@org_onosproject_onos//tools/build/jdk:default_toolchain
 
@@ -16,5 +29,5 @@
 test --test_output=errors
 test --test_verbose_timeout_warnings
 
-#build --disk_cache=~/bazel-cache
-#build --remote_http_cache=http://10.1.10.224:80/cache
+# build --disk_cache=~/bazel-cache
+# build --remote_http_cache=http://10.1.10.224:80/cache