https://github.com/DavidSpickett created https://github.com/llvm/llvm-project/pull/200365
Following the way clang does it. * Converted Maintainers.rst into Maintainers.md. * 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. >From 8e3886771519638a09a09d6a3d1f6910534c6b43 Mon Sep 17 00:00:00 2001 From: David Spickett <[email protected]> Date: Fri, 29 May 2026 09:48:27 +0100 Subject: [PATCH] [clang-tools-extra][docs] Convert maintainers file to Markdown Following the way clang does it. * Converted Maintainers.rst into Maintainers.md. * 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 | 82 +++++++++++++++++++++++++ clang-tools-extra/Maintainers.rst | 84 -------------------------- clang-tools-extra/docs/Maintainers.md | 2 + clang-tools-extra/docs/Maintainers.rst | 1 - clang-tools-extra/docs/conf.py | 5 +- 5 files changed, 87 insertions(+), 87 deletions(-) create mode 100644 clang-tools-extra/Maintainers.md delete mode 100644 clang-tools-extra/Maintainers.rst create mode 100644 clang-tools-extra/docs/Maintainers.md delete mode 100644 clang-tools-extra/docs/Maintainers.rst diff --git a/clang-tools-extra/Maintainers.md b/clang-tools-extra/Maintainers.md new file mode 100644 index 0000000000000..57f7d96213d75 --- /dev/null +++ b/clang-tools-extra/Maintainers.md @@ -0,0 +1,82 @@ +# Clang Tools Extra Maintainers + +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} Table of Contents +:depth: 2 +``` + +# 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](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) + +Zeyi Xu \ [email protected] (email), [zeyi2](https://github.com/zeyi2) (Github), zeyi2 (Discourse), zeyi1 (Discord) + + +## clang-query + +Aaron Ballman \ [email protected] (email), aaron.ballman (Phabricator), [AaronBallman](https://github.com/AaronBallman) (GitHub), AaronBallman (Discourse), aaronballman (Discord) + + +## clang-doc + +Paul Kirth \ [email protected] (email), [ilovepi](https://github.com/ilovepi) (GitHub), ilovepi (Discourse) + +Erick Velez \ [email protected] (email), [evelez7](https://github.com/evelez7) (GitHub), evelez (Discourse), erick.velez (Discord) + + +## clangd + +Nathan Ridge \ [email protected] (email), [HighCommander4](https://github.com/HighCommander4) (GitHub), HighCommander4 (Discourse), nridge (Discord) + +Aleksandr Platonov \ [email protected] (email), [ArcsinX](https://github.com/ArcsinX) (GitHub), ArcsinX (Discourse) + + +# 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](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/Maintainers.rst b/clang-tools-extra/Maintainers.rst deleted file mode 100644 index 8c17ba2185bc3..0000000000000 --- a/clang-tools-extra/Maintainers.rst +++ /dev/null @@ -1,84 +0,0 @@ -============================= -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. - -.. contents:: - :depth: 2 - :local: - -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) - - -clang-tidy ----------- -| Julian Schmidt -| [email protected] (email), 5chmidti (GitHub), 5chmidti (Discourse), 5chmidti (Discord) - -| Victor Baranov -| [email protected] (email), vbvictor (GitHub), vbvictor (Discourse), vbvictor (Discord) - -| Victor Chernyakin -| [email protected] (email), localspook (GitHub), LocalSpook (Discourse), localspook (Discord) - -| Zeyi Xu -| [email protected] (email), zeyi2 (Github), zeyi2 (Discourse), zeyi1 (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 (GitHub), ilovepi (Discourse) - -| Erick Velez -| [email protected] (email), evelez7 (GitHub), evelez (Discourse), erick.velez (Discord) - - -clangd ------- -| Nathan Ridge -| [email protected] (email), HighCommander4 (GitHub), HighCommander4 (Discourse), nridge (Discord) - -| Aleksandr Platonov -| [email protected] (email), ArcsinX (GitHub), ArcsinX (Discourse) - - -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 diff --git a/clang-tools-extra/docs/Maintainers.md b/clang-tools-extra/docs/Maintainers.md new file mode 100644 index 0000000000000..66053697103b9 --- /dev/null +++ b/clang-tools-extra/docs/Maintainers.md @@ -0,0 +1,2 @@ +```{include} ../Maintainers.md +``` \ No newline at end of file diff --git a/clang-tools-extra/docs/Maintainers.rst b/clang-tools-extra/docs/Maintainers.rst deleted file mode 100644 index f78e9ecf279a6..0000000000000 --- a/clang-tools-extra/docs/Maintainers.rst +++ /dev/null @@ -1 +0,0 @@ -.. include:: ../Maintainers.rst \ No newline at end of file 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' _______________________________________________ cfe-commits mailing list [email protected] https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
