[llvm-branch-commits] [clang-tools-extra] [clang-tidy][docs] Rewrite modernize check docs to Markdown [1/4] (PR #232207)

[via llvm-branch-commits]

================
@@ -10,74 +10,75 @@ Standard [depr.c.headers] section.
 This check replaces C standard library headers with their C++ alternatives and
 removes redundant ones.
 
-.. code-block:: c++
+```c++
+// C++ source file...
+#include <assert.h>
+#include <stdbool.h>
 
-  // C++ source file...
-  #include <assert.h>
-  #include <stdbool.h>
+// becomes
 
-  // becomes
-
-  #include <cassert>
-  // No 'stdbool.h' here.
+#include <cassert>
+// No 'stdbool.h' here.
+```
 
 Important note: the Standard doesn't guarantee that the C++ headers declare all
 the same functions in the global namespace. The check in its current form can
 break the code that uses library symbols from the global namespace.
 
-* `<assert.h>`
-* `<complex.h>`
-* `<ctype.h>`
-* `<errno.h>`
-* `<fenv.h>`     // deprecated since C++11
-* `<float.h>`
-* `<inttypes.h>`
-* `<limits.h>`
-* `<locale.h>`
-* `<math.h>`
-* `<setjmp.h>`
-* `<signal.h>`
-* `<stdarg.h>`
-* `<stddef.h>`
-* `<stdint.h>`
-* `<stdio.h>`
-* `<stdlib.h>`
-* `<string.h>`
-* `<tgmath.h>`   // deprecated since C++11
-* `<time.h>`
-* `<uchar.h>`    // deprecated since C++11
-* `<wchar.h>`
-* `<wctype.h>`
+- `<assert.h>`
+- `<complex.h>`
+- `<ctype.h>`
+- `<errno.h>`
+- `<fenv.h>` // deprecated since C++11
+- `<float.h>`
+- `<inttypes.h>`
+- `<limits.h>`
+- `<locale.h>`
+- `<math.h>`
+- `<setjmp.h>`
+- `<signal.h>`
+- `<stdarg.h>`
+- `<stddef.h>`
+- `<stdint.h>`
+- `<stdio.h>`
+- `<stdlib.h>`
+- `<string.h>`
+- `<tgmath.h>` // deprecated since C++11
+- `<time.h>`
+- `<uchar.h>` // deprecated since C++11
+- `<wchar.h>`
+- `<wctype.h>`
 
 If the specified standard is older than C++11 the check will only replace
 headers deprecated before C++11, otherwise -- every header that appeared in
----------------
EugeneZelenko wrote:

```suggestion
headers deprecated before C++11, otherwise every header that appeared in
```

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