Add complete documentation to README

Created by: Niklas Korsbo

I think that the README will suffice for now. But we need to describe everything.

Imported comments:

By Niklas Korsbo on 2018-09-04T13:09:47.733Z

This is turning out to be long and verbose. At some point we should create a documentation webpage and leave a teaser in the README.