update readme + comments