clean-up of README. resolves #1 and resolves #2