[PATCH 0/8] Auto-generate maintainer profile entries

[Mauro Carvalho Chehab]

Date: Tue, 14 Apr 2026 16:29:03 +0200
From: Mauro Carvalho Chehab <mchehab+huawei at kernel.org>
To: Albert Ou <aou at eecs.berkeley.edu>, Jonathan Corbet <corbet at lwn.net>, Dan Williams <djbw at kernel.org>, Mauro Carvalho Chehab <mchehab at kernel.org>, Palmer Dabbelt <palmer at dabbelt.com>, Paul Walmsley <pjw at kernel.org>
Cc: Mauro Carvalho Chehab <mchehab+huawei at kernel.org>, Randy Dunlap <rdunlap at infradead.org>, linux-doc at vger.kernel.org, linux-kernel at vger.kernel.org, linux-riscv at lists.infradead.org, workflows at vger.kernel.org, Alexandre Ghiti <alex at ghiti.fr>, Shuah Khan <skhan at linuxfoundation.org>
Message-ID: <cover.1776176108.git.mchehab+huawei at kernel.org>

Hi Dan/Jon,

This patch series change the way maintainer entry profile links
are added to the documentation. Instead of having an entry for
each of them at an ReST file, get them from MAINTAINERS content.

That should likely make easier to maintain, as there will be a single
point to place all such profiles.

On this version, I added Dan's text to patch 4.

I also added a couple of other patches to improve its output. While
I could have them merged at the first patch, I opted to make them
separate, as, in case of problems or needed changes, it would be
easier to revert or modify the corresponding logic. Also, it should
be better to review, in case one wants some changes there.

The main changes against RFC are:

- now, the TOC will be presented with 1 depth identation level,
  meaning that it would look like a list;
- for files outside Documentation/process, it will use the name of
  the subsystem with title capitalization for the name of the
  profile entry;
- the logic also parses and produces a list of profiles that are
  maintained elsewhere, picking its http/https link;
- entries are now better sorted: first by subsystem name, then
  by its name.

Suggested-by: Dan Williams <djbw at kernel.org>
Closes: https://lore.kernel.org/linux-doc/69dd6299440be_147c801005b@djbw-dev.notmuch/

Mauro Carvalho Chehab (8):
  docs: maintainers_include: auto-generate maintainer profile TOC
  MAINTAINERS: add an entry for media maintainers profile
  MAINTAINERS: add maintainer-tip.rst to X86
  docs: auto-generate maintainer entry profile links
  docs: maintainers_include: use a better title for profiles
  docs: maintainers_include: add external profile URLs
  docs: maintainers_include: preserve names for files under process/
  docs: maintainers_include: Only show main entry for profiles

 .../maintainer/maintainer-entry-profile.rst   |  24 +---
 .../process/maintainer-handbooks.rst          |  17 ++-
 Documentation/sphinx/maintainers_include.py   | 131 +++++++++++++++---
 MAINTAINERS                                   |   2 +
 4 files changed, 128 insertions(+), 46 deletions(-)

-- 
2.53.0