diff --git a/site/docs/tutorial/java.md b/site/docs/tutorial/java.md
index 8352229..b1ed79d 100644
--- a/site/docs/tutorial/java.md
+++ b/site/docs/tutorial/java.md
@@ -27,6 +27,7 @@
 
 *  [Before you begin](#before-you-begin)
    *  [Install Bazel](#install-bazel)
+   *  [Install the JDK](#install-the-jdk)
    *  [Get the sample project](#get-the-sample-project)
 *  [Build with Bazel](#build-with-bazel)
    *  [Set up the workspace](#set-up-the-workspace)
@@ -47,6 +48,23 @@
 To prepare for the tutorial, first [Install Bazel](../install.md) if
 you don't have it installed already.
 
+### Install the JDK
+
+1.  Install Java 8 JDK.
+
+2.  Set the JAVA\_HOME environment variable to point to the JDK.
+    *   On Linux/macOS:
+
+            export JAVA_HOME="$(dirname $(dirname $(realpath $(which javac))))"
+    *   On Windows:
+        1.  Open Control Panel.
+        2.  Go to "System&nbsp;and&nbsp;Security" &gt; "System" &gt; "Advanced&nbsp;System&nbsp;Settings" &gt; "Advanced"&nbsp;tab &gt; "Environment&nbsp;Variables..." .
+        3.  Under the "User&nbsp;variables" list (the one on the top), click "New...".
+        4.  In the "Variable&nbsp;name" field, enter `JAVA_HOME`.
+        5.  Click "Browse&nbsp;Directory...".
+        6.  Navigate to the JDK directory (for example `C:\Program&nbsp;Files\Java\jdk1.8.0_152`).
+        7.  Click "OK" on all dialog windows.
+
 ### Get the sample project
 
 Retrieve the sample project from Bazel's GitHub repository:
@@ -60,7 +78,6 @@
 
 ```
 java-tutorial
-│
 ├── BUILD
 ├── src
 │   └── main