halfway readme:
Revise readme and comments