update readme, better comments