update comments and readme file