[clang-tools-extra] [llvm] [Github][CI] Add `doc8` for clang-tidy documentation formatting (PR #168827)

[Baranov Victor via llvm-commits]

================
@@ -124,133 +92,205 @@ def create_comment_text(warning: str, cpp_files: List[str]) -> str:
 
 <details>
 <summary>
-View the output from clang-tidy here.
+View the output from {self.name} here.
 </summary>
 
 ```
-{warning}
+{linter_output}
 ```
 
 </details>
 """
 
+    # TODO: Refactor this
----------------
vbvictor wrote:

what is the idea behind refactor? 

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