Add documentation

Resolves #19.
Added the necessary information to the README. The idea is to let a new user take a quick look and understand how to use the API.
ya, it's one of the few painpoints of markdown...