added some comments to the markdown for more accurate parsing