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

[Paul Kirth via cfe-commits]

https://github.com/ilovepi commented:

I'll take another pass later in the week, but here are some initial comments.

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