update (comments + readme)