added some comments to guide changes