update readme for feature/two

merging so that feature/one PR goes stale...