MAINTAINERS file is now generated
The MAINTAINERS file in GCC is now generated from MAINTAINERS.yml, with a script to assist in adding new entries.
The MAINTAINERS file within the GCC project is now automatically generated, with MAINTAINERS.yml serving as the master source. A script, contrib/add-write-after.py, is provided to help with the creation of new entries in the YAML file. The testsuite has been updated to ensure synchronization, and web pages have been updated to reflect the new process.
- proposer
Announces that the MAINTAINERS file is now generated from MAINTAINERS.yml, providing a script for adding new entries and mentioning testsuite updates and web page documentation.
“Just a heads up that the MAINTAINERS file is now a generated file. The master copy for the input is now in MAINTAINERS.yml, which lives along-side it. For new write-after accounts there is a script that should do most of the work of creating a new entry in MAINTAINERS.yml; just run contrib/add-write-after.py. The testsuite has been updated to validate that the MAINTAINERS file is in sync with…”
In Details
GCC has automated the generation of its MAINTAINERS file, historically a manually curated list of subsystem maintainers and reviewers. The new process uses MAINTAINERS.yml as the source of truth, managed via a script (contrib/add-write-after.py) for new entries, and validated by the testsuite. This change impacts how project contributors and maintainers are registered and keeps the MAINTAINERS file in sync with the .yml source.
- MAINTAINERS file
- A file in a software project repository that lists the individuals responsible for maintaining different parts of the codebase. It's used to direct patch reviews and queries to the appropriate people.
- MAINTAINERS.yml
- A YAML-formatted file used as the source for generating the MAINTAINERS file in GCC. It likely contains structured data about maintainers, reviewers, and subsystems.
- write-after
- Refers to a reviewer who has been granted commit rights or a similar trusted status for a specific subsystem.
- testsuite
- A collection of tests designed to verify the correctness and functionality of the software.
- commit rights
- The permission granted to a user to directly commit changes to the project's version control repository.