[clang-tools-extra] Refactor clang doc comment structure (PR #142273)

[Paul Kirth via cfe-commits]

https://github.com/ilovepi approved this pull request.

LGTM once the last few nits are addressed.

https://github.com/llvm/llvm-project/pull/142273