Add preliminary docs from https://gist.github.com/testobsessed/ad4fbbbd6ff3cc6f0f4d
Move API docs into reference section, and refer from both using and running section
merging reference changes from david laing