Update style documentation for doc comments

Document the expected tense for doc comment summaries, and elaborate on
the supported Markdown syntax.