added some markdown explanation