refactor readme. reformat mapping and collections