diff --git a/java/demo/README b/java/demo/README
deleted file mode 100644
index 0bc32d88a..000000000
--- a/java/demo/README
+++ /dev/null
@@ -1,6 +0,0 @@
-Prerequisite:
-  Install the Appengine SDK.
-  $ sudo apt-get install google-cloud-sdk-app-engine-java
-
-How to regenreate the WAR, deploy and run in appengine?
-  $ mvn appengine:run
diff --git a/java/demo/README.md b/java/demo/README.md
new file mode 100644
index 000000000..abe000d7b
--- /dev/null
+++ b/java/demo/README.md
@@ -0,0 +1,15 @@
+## Prerequisite:
+
+### Linux
+#### Install the Appengine SDK.
+`$ sudo apt-get install google-cloud-sdk-app-engine-java`
+
+### Mac
+#### Install the Google Cloud SDK.
+`$ brew install google-cloud-sdk`
+
+#### Use GCloud CLI to install the Java Appengine
+`$ gcloud components install app-engine-java`
+
+## How to regenerate the WAR, deploy and run in appengine?
+`$ mvn appengine:run`
\ No newline at end of file