add some comments for markdown auto generation