updated README with comments from proposal