diff --git a/java/readme.md b/java/readme.md
new file mode 100644
index 0000000000000000000000000000000000000000..3b2525c596a4c86c9ae0e305cda0aac5d39367f8
--- /dev/null
+++ b/java/readme.md
@@ -0,0 +1,26 @@
+## Compiling and Running Java Demos
+
+To make ("compile") an example, use the included makefile with 
+the name of the java file passed as a variable. For example, to make hello.java:
+
+```bash
+	make NAME="hello"
+```
+
+Then, to run:
+
+```bash
+    java hello 
+```
+
+Or you can compile and run in one step:
+
+```bash
+    make run NAME="hello"
+```
+
+You can also clean temporary `.class` files:
+
+```bash
+    make clean
+```
\ No newline at end of file