Date: Tue, 14 Apr 2026 16:29:03 +0200 From: Mauro Carvalho Chehab <[email protected]> To: Albert Ou <[email protected]>, Jonathan Corbet <[email protected]>, Dan Williams <[email protected]>, Mauro Carvalho Chehab <[email protected]>, Palmer Dabbelt <[email protected]>, Paul Walmsley <[email protected]> Cc: Mauro Carvalho Chehab <[email protected]>, Randy Dunlap <[email protected]>, [email protected], [email protected], [email protected], [email protected], Alexandre Ghiti <[email protected]>, Shuah Khan <[email protected]> Message-ID: <[email protected]>
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 <[email protected]> Closes: https://lore.kernel.org/linux-doc/[email protected]/ 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
