README updates, minor code changes for clarity