added markdown comments