last minute updates

- README
- improve comment context