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.
lookup table in error message here as well