More documentation
cleaned up define API, updated readme a bit more