final submission: added detailed readme