readme and path fix

docker/execute

@@ -17,8 +17,8 @@ if [ -z "$2" ]; then
 fi
 
 lang=$1
-abs=$2
-file=$(basename $abs)
+filepath=$(realpath $2)
+file=$(basename $2)
 
 bin=
 case "$lang" in
@@ -53,7 +53,7 @@ docker run \
     --network none \
     --cpus=".5" \
     --rm \
-    -v $abs:/$file:ro \
+    -v $filepath:/$file:ro \
     -v $dir/executors/python2:/executor_python2:ro \
     -v $dir/executors/python3:/executor_python3:ro \
     -v $dir/executors/ruby:/executor_ruby:ro \
@@ -62,6 +62,8 @@ docker run \
     -v $dir/executors/cpp:/executor_cpp:ro \
     -v $dir/executors/go:/executor_go:ro \
     piston \
-    runuser -l runner -c "/$bin /$file $file 2>&1"
+    runuser \
+        -l runner \
+        -c "/$bin /$file $file 2>&1"
 
 rm -f /tmp/$file

readme.md

@@ -1 +1,22 @@
-### piston
+## Piston
+This project is the underlying engine for running untrusted and possibly malicious code that originates
+from from EMKC contests and challenges.
+
+
+#### Installation
+- Install Docker https://www.docker.com/get-started
+- `git clone https://github.com/engineer-man/piston`
+- `cd piston/docker`
+- `./build`
+
+
+#### Usage
+- `docker/execute <lang> <path to file>`
+
+
+#### Supported Languages
+Currently python2, python3, c, c++, go, node, and ruby are supported.
+
+
+#### License
+Piston is licensed under the MIT license.