Skip to content

maintainers.md (remove duplication, add council) - #4

Merged
vuvova merged 4 commits into
mainfrom
pr-4
Aug 6, 2026
Merged

maintainers.md (remove duplication, add council)#4
vuvova merged 4 commits into
mainfrom
pr-4

Conversation

@vuvova

@vuvova vuvova commented Aug 5, 2026

Copy link
Copy Markdown
Member

This pull request restructures and clarifies the documentation around maintainers, subsystems, and governance processes for the MariaDB Server project. The main improvements include moving subsystem and maintainer lists to a dedicated file, enhancing the organization of the maintainers.md file, and updating the README.md to reflect these changes and clarify decision-making processes.

Key changes:

Documentation structure and clarity:

  • The list of stewards, subsystems, and maintainers has been moved from maintainers.md to a new dedicated file at lists/maintainers.md, improving maintainability and clarity. The main maintainers.md file now links to this new list and provides instructions on how to interpret it. [1] [2]
  • The maintainers.md file has been reorganized to clarify the roles of stewards, the Maintainer Council, and the process for updating the maintainer list, as well as detailing voting and decision-recording procedures.

Content updates and corrections:

  • The subsystem and maintainer details in lists/maintainers.md have been updated, including clearer scope definitions, maintainer affiliations, and status for each subsystem. Some maintainer assignments and affiliations were corrected or clarified.

README and process improvements:

  • The README.md now lists all governance and policy documents in a more logical order and clarifies the processes for changing the repository, including explicit references to both governance and maintainers' decision-making procedures.

General formatting and consistency:

  • Headings and formatting in committers.md and maintainers.md have been standardized for consistency and readability. [1] [2]

These changes collectively improve the transparency, organization, and maintainability of the project's governance documentation.

@vuvova vuvova changed the title remove the second copy of the list of maintainers maintainers.md (remove duplication, add council) Aug 6, 2026
@vuvova
vuvova marked this pull request as draft August 6, 2026 08:37
@vuvova
vuvova marked this pull request as ready for review August 6, 2026 10:33
@vuvova
vuvova requested a review from gkodinov August 6, 2026 10:34
@vuvova

vuvova commented Aug 6, 2026

Copy link
Copy Markdown
Member Author

@gkodinov , in particular, see what I did with lists/maintainers.md and double-check whether it's ok with your approach. I tried to match your grep pattern

@gkodinov gkodinov left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, one question to you below.

Comment thread lists/maintainers.md
#### **Stewards**

* [Michael Widenius](https://github.com/montywi)
— MariaDB plc, MariaDB Foundation

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It should work fine with the verification trigger, that I'm still hoping you'd review (#2). As long as you stay within the bounds of the 2 regular expressions I have there. It's easy to check too: https://github.com/MariaDB/governance/actions/runs/30815060977/job/92624664743.
However, it'd be hard to correlate the extra structure here in any kind of automated parser script.
If that's not a goal, then it's fine by me.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From what I've seen, you grep for ^ *\* , we can keep these lines strictly for membership lists and add any additional info only in a way that does not match this pattern. Then it'll work. The parser will grep and process the output, everything else is filtered out.

@vuvova
vuvova merged commit 87b7711 into main Aug 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants