added some markdown comments