[docs] Fix typo, align comments, fix syntax highlighting