diff --git a/build/build.sh b/build/build.sh
old mode 100644
new mode 100755
index 691ee00a..bac62d40
--- a/build/build.sh
+++ b/build/build.sh
@@ -1,6 +1,10 @@
 #!/bin/bash
 
+# create json directory if not already present
 mkdir -p ../json
+# parse API README and print (minified) JSON to stdout, redirect to /json
 node md2json.js ../README.md > ../json/api.min.json
+# beautify the previously created JSON file, redirect to /json
 python -m json.tool ../json/api.min.json > ../json/api.json
+# print out pretty JSON (useful for debugging, checking for new entries, etc) 
 cat ../json/api.json