comment & readme improvements