updated comments to use Markdown