add explanatory comments to the readme