added some comments to the md file