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 <[email protected]> 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 <[email protected]> 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 -| [email protected] (email), aaron.ballman (Phabricator), AaronBallman (GitHub), AaronBallman (Discourse), aaronballman (Discord) +## Lead Maintainer + +Aaron Ballman \ [email protected] (email), aaron.ballman (Phabricator), [AaronBallman](https://github.com/AaronBallman) (GitHub), AaronBallman (Discourse), aaronballman (Discord) + + +## clang-tidy + +Julian Schmidt \ [email protected] (email), [5chmidti](https://github.com/5chmidti) (GitHub), 5chmidti (Discourse), 5chmidti (Discord) + +Victor Baranov \ [email protected] (email), [vbvictor](https://github.com/vbvictor) (GitHub), vbvictor (Discourse), vbvictor (Discord) +Victor Chernyakin \ [email protected] (email), [localspook](https://github.com/localspook) (GitHub), LocalSpook (Discourse), localspook (Discord) -clang-tidy ----------- -| Julian Schmidt -| [email protected] (email), 5chmidti (GitHub), 5chmidti (Discourse), 5chmidti (Discord) +Zeyi Xu \ [email protected] (email), [zeyi2](https://github.com/zeyi2) (Github), zeyi2 (Discourse), zeyi1 (Discord) -| Victor Baranov -| [email protected] (email), vbvictor (GitHub), vbvictor (Discourse), vbvictor (Discord) -| Victor Chernyakin -| [email protected] (email), localspook (GitHub), LocalSpook (Discourse), localspook (Discord) +## clang-query -| Zeyi Xu -| [email protected] (email), zeyi2 (Github), zeyi2 (Discourse), zeyi1 (Discord) +Aaron Ballman \ [email protected] (email), aaron.ballman (Phabricator), [AaronBallman](https://github.com/AaronBallman) (GitHub), AaronBallman (Discourse), aaronballman (Discord) -clang-query ------------ -| Aaron Ballman -| [email protected] (email), aaron.ballman (Phabricator), AaronBallman (GitHub), AaronBallman (Discourse), aaronballman (Discord) +## clang-doc +Paul Kirth \ [email protected] (email), [ilovepi](https://github.com/ilovepi) (GitHub), ilovepi (Discourse) -clang-doc ---------- -| Paul Kirth -| [email protected] (email), ilovepi (GitHub), ilovepi (Discourse) +Erick Velez \ [email protected] (email), [evelez7](https://github.com/evelez7) (GitHub), evelez (Discourse), erick.velez (Discord) -| Erick Velez -| [email protected] (email), evelez7 (GitHub), evelez (Discourse), erick.velez (Discord) +## clangd -clangd ------- -| Nathan Ridge -| [email protected] (email), HighCommander4 (GitHub), HighCommander4 (Discourse), nridge (Discord) +Nathan Ridge \ [email protected] (email), [HighCommander4](https://github.com/HighCommander4) (GitHub), HighCommander4 (Discourse), nridge (Discord) -| Aleksandr Platonov -| [email protected] (email), ArcsinX (GitHub), ArcsinX (Discourse) +Aleksandr Platonov \ [email protected] (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 ([email protected] (email), r4nt (GitHub)) - - -Inactive component maintainers ------------------------------- -| Nathan James ([email protected]) -- clang-tidy -| Julie Hockett ([email protected]) -- clang-doc -| Sam McCall ([email protected] (email), sam-mccall (GitHub, Discourse, Discord)) -- clangd -| Peter Chou ([email protected] (email), PeterChou1 (GitHub, Discourse), .peterchou (Discord)) -- clang-doc -| Piotr Zegar ([email protected] (email), PiotrZSL (GitHub), PiotrZSL (Discourse), PiotrZSL (Discord)) -- clang-tidy -| Kadir Çetinkaya ([email protected] (email), kadircet (GitHub) kadircet (Discourse), kadircet (Discord)) -- clangd -| Chris Bieneman ([email protected] (email), llvm-beanz (GitHub), beanz (Discord), beanz (Discourse)) -- clangd -| Congcong Cai ([email protected] (email), HerrCai0907 (GitHub), HerrCai0907 (Discourse)) -- clang-tidy +## Emeritus Lead Maintainers + +Manuel Klimek ([email protected] (email), [r4nt](https://github.com/r4nt) (GitHub)) + + +## Inactive component maintainers + +Nathan James ([email protected]) \-- clang-tidy \ +Julie Hockett ([email protected]) \-- clang-doc \ +Sam McCall ([email protected] (email), sam-mccall (GitHub, Discourse, Discord)) \-- clangd \ +Peter Chou ([email protected] (email), PeterChou1 (GitHub, Discourse), .peterchou (Discord)) \-- clang-doc \ +Piotr Zegar ([email protected] (email), [PiotrZSL](https://github.com/PiotrZSL) (GitHub), PiotrZSL (Discourse), PiotrZSL (Discord)) \-- clang-tidy \ +Kadir Çetinkaya ([email protected] (email), [kadircet](https://github.com/kadircet) (GitHub) kadircet (Discourse), kadircet (Discord)) \-- clangd \ +Chris Bieneman ([email protected] (email), [llvm-beanz](https://github.com/llvm-beanz) (GitHub), beanz (Discord), beanz (Discourse)) \-- clangd \ +Congcong Cai ([email protected] (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) _______________________________________________ cfe-commits mailing list [email protected] https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
