update readme, improve comments