adding some basic documentation
minor README changes