[clang-tools-extra] [llvm] [clang-tools-extra][docs] Convert maintainers file to Markdown (PR #200365)
David Spickett via cfe-commits
cfe-commits at lists.llvm.org
Mon Jun 1 03:08:05 PDT 2026
https://github.com/DavidSpickett updated https://github.com/llvm/llvm-project/pull/200365
>From 8977a43a46713a62ba460ec468dc42bd6f4a8392 Mon Sep 17 00:00:00 2001
From: David Spickett <david.spickett at arm.com>
Date: Mon, 1 Jun 2026 10:49:54 +0100
Subject: [PATCH 1/2] [clang-tools-extra] Move maintainer files to .md files
Without any formatting changes. This will break the docs build,
but a follow up will fix the formatting and so on.
---
clang-tools-extra/{Maintainers.rst => Maintainers.md} | 0
clang-tools-extra/docs/{Maintainers.rst => Maintainers.md} | 0
2 files changed, 0 insertions(+), 0 deletions(-)
rename clang-tools-extra/{Maintainers.rst => Maintainers.md} (100%)
rename clang-tools-extra/docs/{Maintainers.rst => Maintainers.md} (100%)
diff --git a/clang-tools-extra/Maintainers.rst b/clang-tools-extra/Maintainers.md
similarity index 100%
rename from clang-tools-extra/Maintainers.rst
rename to clang-tools-extra/Maintainers.md
diff --git a/clang-tools-extra/docs/Maintainers.rst b/clang-tools-extra/docs/Maintainers.md
similarity index 100%
rename from clang-tools-extra/docs/Maintainers.rst
rename to clang-tools-extra/docs/Maintainers.md
>From 26013a5884266306382d459ed5673bb43e6c81d7 Mon Sep 17 00:00:00 2001
From: David Spickett <david.spickett at arm.com>
Date: Fri, 29 May 2026 09:48:27 +0100
Subject: [PATCH 2/2] [clang-tools-extra][docs] Convert maintainers file to
Markdown
Following the way clang does it.
* Renamed rst files to md (done in a previous commit).
* Reformated rst into markdown.
* Changed the stub file docs/Maintainers.rst into
docs/Maintainers.md and used a myst directive
for the include.
* In the config file, added myst parser and ".md"
as a recognised file extension.
After this change, all maintainers files in llvm-project
will be in Markdown format.
---
clang-tools-extra/Maintainers.md | 114 +++++++++++++-------------
clang-tools-extra/docs/Maintainers.md | 3 +-
clang-tools-extra/docs/conf.py | 5 +-
llvm/Maintainers.md | 2 +-
4 files changed, 62 insertions(+), 62 deletions(-)
diff --git a/clang-tools-extra/Maintainers.md b/clang-tools-extra/Maintainers.md
index 8c17ba2185bc3..57f7d96213d75 100644
--- a/clang-tools-extra/Maintainers.md
+++ b/clang-tools-extra/Maintainers.md
@@ -1,84 +1,82 @@
-=============================
-Clang Tools Extra Maintainers
-=============================
+# Clang Tools Extra Maintainers
-This file is a list of the
-`maintainers <https://llvm.org/docs/DeveloperPolicy.html#maintainers>`_
-for `Extra Clang Tools <https://clang.llvm.org/extra/index.html>`_ project.
+This file is a list of the
+[maintainers](https://llvm.org/docs/DeveloperPolicy.html#maintainers)
+for the [Extra Clang Tools](https://clang.llvm.org/extra/index.html) project.
-.. contents::
- :depth: 2
- :local:
+```{contents} Table of Contents
+:depth: 2
+```
+
+# Active Maintainers
-Active Maintainers
-==================
The following people are the active maintainers for the project. Please reach
out to them for code reviews, questions about their area of expertise, or other
assistance.
-Lead Maintainer
----------------
-| Aaron Ballman
-| aaron at aaronballman.com (email), aaron.ballman (Phabricator), AaronBallman (GitHub), AaronBallman (Discourse), aaronballman (Discord)
+## Lead Maintainer
+
+Aaron Ballman \
+aaron at aaronballman.com (email), aaron.ballman (Phabricator), [AaronBallman](https://github.com/AaronBallman) (GitHub), AaronBallman (Discourse), aaronballman (Discord)
+
+
+## clang-tidy
+
+Julian Schmidt \
+git.julian.schmidt at gmail.com (email), [5chmidti](https://github.com/5chmidti) (GitHub), 5chmidti (Discourse), 5chmidti (Discord)
+
+Victor Baranov \
+bar.victor.2002 at gmail.com (email), [vbvictor](https://github.com/vbvictor) (GitHub), vbvictor (Discourse), vbvictor (Discord)
+Victor Chernyakin \
+chernyakin.victor.j at outlook.com (email), [localspook](https://github.com/localspook) (GitHub), LocalSpook (Discourse), localspook (Discord)
-clang-tidy
-----------
-| Julian Schmidt
-| git.julian.schmidt at gmail.com (email), 5chmidti (GitHub), 5chmidti (Discourse), 5chmidti (Discord)
+Zeyi Xu \
+zeyi2 at nekoarch.cc (email), [zeyi2](https://github.com/zeyi2) (Github), zeyi2 (Discourse), zeyi1 (Discord)
-| Victor Baranov
-| bar.victor.2002 at gmail.com (email), vbvictor (GitHub), vbvictor (Discourse), vbvictor (Discord)
-| Victor Chernyakin
-| chernyakin.victor.j at outlook.com (email), localspook (GitHub), LocalSpook (Discourse), localspook (Discord)
+## clang-query
-| Zeyi Xu
-| zeyi2 at nekoarch.cc (email), zeyi2 (Github), zeyi2 (Discourse), zeyi1 (Discord)
+Aaron Ballman \
+aaron at aaronballman.com (email), aaron.ballman (Phabricator), [AaronBallman](https://github.com/AaronBallman) (GitHub), AaronBallman (Discourse), aaronballman (Discord)
-clang-query
------------
-| Aaron Ballman
-| aaron at aaronballman.com (email), aaron.ballman (Phabricator), AaronBallman (GitHub), AaronBallman (Discourse), aaronballman (Discord)
+## clang-doc
+Paul Kirth \
+paulkirth at google.com (email), [ilovepi](https://github.com/ilovepi) (GitHub), ilovepi (Discourse)
-clang-doc
----------
-| Paul Kirth
-| paulkirth at google.com (email), ilovepi (GitHub), ilovepi (Discourse)
+Erick Velez \
+erickvelez7 at gmail.com (email), [evelez7](https://github.com/evelez7) (GitHub), evelez (Discourse), erick.velez (Discord)
-| Erick Velez
-| erickvelez7 at gmail.com (email), evelez7 (GitHub), evelez (Discourse), erick.velez (Discord)
+## clangd
-clangd
-------
-| Nathan Ridge
-| zeratul976 at hotmail.com (email), HighCommander4 (GitHub), HighCommander4 (Discourse), nridge (Discord)
+Nathan Ridge \
+zeratul976 at hotmail.com (email), [HighCommander4](https://github.com/HighCommander4) (GitHub), HighCommander4 (Discourse), nridge (Discord)
-| Aleksandr Platonov
-| arcsinx45 at gmail.com (email), ArcsinX (GitHub), ArcsinX (Discourse)
+Aleksandr Platonov \
+arcsinx45 at gmail.com (email), [ArcsinX](https://github.com/ArcsinX) (GitHub), ArcsinX (Discourse)
-Inactive Maintainers
-====================
+# Inactive Maintainers
+
The following people have graciously spent time performing maintainership
responsibilities but are no longer active in that role. Thank you for all your
help with the success of the project!
-Emeritus Lead Maintainers
--------------------------
-| Manuel Klimek (klimek at google.com (email), r4nt (GitHub))
-
-
-Inactive component maintainers
-------------------------------
-| Nathan James (n.james93 at hotmail.co.uk) -- clang-tidy
-| Julie Hockett (juliehockett at google.com) -- clang-doc
-| Sam McCall (sammccall at google.com (email), sam-mccall (GitHub, Discourse, Discord)) -- clangd
-| Peter Chou (peterchou411 at gmail.com (email), PeterChou1 (GitHub, Discourse), .peterchou (Discord)) -- clang-doc
-| Piotr Zegar (me at piotrzegar.pl (email), PiotrZSL (GitHub), PiotrZSL (Discourse), PiotrZSL (Discord)) -- clang-tidy
-| Kadir Çetinkaya (kadircet at google.com (email), kadircet (GitHub) kadircet (Discourse), kadircet (Discord)) -- clangd
-| Chris Bieneman (chris.bieneman at gmail.com (email), llvm-beanz (GitHub), beanz (Discord), beanz (Discourse)) -- clangd
-| Congcong Cai (congcongcai0907 at 163.com (email), HerrCai0907 (GitHub), HerrCai0907 (Discourse)) -- clang-tidy
+## Emeritus Lead Maintainers
+
+Manuel Klimek (klimek at google.com (email), [r4nt](https://github.com/r4nt) (GitHub))
+
+
+## Inactive component maintainers
+
+Nathan James (n.james93 at hotmail.co.uk) \-- clang-tidy \
+Julie Hockett (juliehockett at google.com) \-- clang-doc \
+Sam McCall (sammccall at google.com (email), sam-mccall (GitHub, Discourse, Discord)) \-- clangd \
+Peter Chou (peterchou411 at gmail.com (email), PeterChou1 (GitHub, Discourse), .peterchou (Discord)) \-- clang-doc \
+Piotr Zegar (me at piotrzegar.pl (email), [PiotrZSL](https://github.com/PiotrZSL) (GitHub), PiotrZSL (Discourse), PiotrZSL (Discord)) \-- clang-tidy \
+Kadir Çetinkaya (kadircet at google.com (email), [kadircet](https://github.com/kadircet) (GitHub) kadircet (Discourse), kadircet (Discord)) \-- clangd \
+Chris Bieneman (chris.bieneman at gmail.com (email), [llvm-beanz](https://github.com/llvm-beanz) (GitHub), beanz (Discord), beanz (Discourse)) \-- clangd \
+Congcong Cai (congcongcai0907 at 163.com (email), [HerrCai0907](https://github.com/HerrCai0907) (GitHub), HerrCai0907 (Discourse)) \-- clang-tidy
diff --git a/clang-tools-extra/docs/Maintainers.md b/clang-tools-extra/docs/Maintainers.md
index f78e9ecf279a6..e9654b20c05a1 100644
--- a/clang-tools-extra/docs/Maintainers.md
+++ b/clang-tools-extra/docs/Maintainers.md
@@ -1 +1,2 @@
-.. include:: ../Maintainers.rst
\ No newline at end of file
+```{include} ../Maintainers.md
+```
diff --git a/clang-tools-extra/docs/conf.py b/clang-tools-extra/docs/conf.py
index feb7a1da63643..b0174894c4e4a 100644
--- a/clang-tools-extra/docs/conf.py
+++ b/clang-tools-extra/docs/conf.py
@@ -13,6 +13,7 @@
import sys, os
from datetime import date
+import myst_parser
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
@@ -26,13 +27,13 @@
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ["sphinx.ext.todo", "sphinx.ext.mathjax"]
+extensions = ["sphinx.ext.todo", "sphinx.ext.mathjax", "myst_parser"]
# Add any paths that contain templates here, relative to this directory.
templates_path = ["_templates"]
# The suffix of source filenames.
-source_suffix = ".rst"
+source_suffix = [".rst", ".md"]
# The encoding of source files.
# source_encoding = 'utf-8-sig'
diff --git a/llvm/Maintainers.md b/llvm/Maintainers.md
index be6840309e231..99176164fd603 100644
--- a/llvm/Maintainers.md
+++ b/llvm/Maintainers.md
@@ -510,7 +510,7 @@ Some subprojects maintain their own list of per-component maintainers.
[Clang maintainers](https://github.com/llvm/llvm-project/blob/main/clang/Maintainers.md)
-[Clang-tools-extra maintainers](https://github.com/llvm/llvm-project/blob/main/clang-tools-extra/Maintainers.rst)
+[Clang-tools-extra maintainers](https://github.com/llvm/llvm-project/blob/main/clang-tools-extra/Maintainers.md)
[Compiler-rt maintainers](https://github.com/llvm/llvm-project/blob/main/compiler-rt/Maintainers.md)
More information about the cfe-commits
mailing list