# Collection maintainer information for collections included in Ansible

**URL:** <https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562>\
**Category:** Project Discussions\
**Tags:** ansible, collections, community-wg\
**Created:** [November 24, 2023, 9:42pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562 "2023-11-24T21:42:40Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\
**Post date:** [November 24, 2023, 9:42pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/1 "2023-11-24T21:42:40Z")

</div>

In the [collection metadata stored in ansible-build-data](https://github.com/ansible-community/ansible-build-data/blob/main/10/collection-meta.yaml) we also keep track of collection maintainers for some time now. Unfortunately these lists aren’t always up to date.

Recently two PRs ([VMware collection maintainers by mariolenz · Pull Request #333 · ansible-community/ansible-build-data · GitHub](https://github.com/ansible-community/ansible-build-data/pull/333), [Standardize info for collections maintained by the Ansible Cloud Team by alinabuzachis · Pull Request #334 · ansible-community/ansible-build-data · GitHub](https://github.com/ansible-community/ansible-build-data/pull/334)) were created to update the maintainer information for some of the Ansible Cloud team maintained collections. It was proposed there to reference GitHub teams (for the Ansible Cloud team, that’s `ansible-collections/cloud`) instead of a list of GitHub usernames since the team members can change a lot, while the team stays.

Unfortunately, pining a team only works inside the organization. So when pinging `ansible-collections/cloud` in an issue in a repository inside the ansible-collections organization the members of the team are pinged (and the name is clickable), but when pinging the same team from the ansible-build-data repository (which is inside the ansible-community organization) the team members will not get notified (and the team name isn’t clickable). What’s worse, the list of team members can only seen by folks who are members of the team’s organization themselves. (I can see the members for `ansible-collections/cloud`, for example, but others cannot.)

So now we have to figure out what to do. Some ideas:

1. Allow all team references. This was opposed by @gotmax23 for example (see [VMware collection maintainers by mariolenz · Pull Request #333 · ansible-community/ansible-build-data · GitHub](https://github.com/ansible-community/ansible-build-data/pull/333#issuecomment-1823423898)).
2. Allow teams only from specific organizations that are part of Ansible, like ansible-collections, ansible-community, ansible-network, and ansible itself. Then at least the Ansible Community team can always look up the member list for us if we can’t see them ourselves.
3. Always request real GitHub usernames instead of team names. We will then likely quickly end up with no longer active names on our lists.
4. Use some automatism to update member lists automatically. This will likely only work for teams in Ansible controlled organizations. Also someone needs to set this up and maintain it.
5. …

If you have other ideas, please mention them here!

---

<div class="post-metadata">

**Author:** ![mariolenz](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/mariolenz/32/108_2.png) [@mariolenz](https://forum.ansible.com/u/mariolenz)\
**Post date:** [November 25, 2023, 12:29pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/2 "2023-11-25T12:29:58Z")

</div>

My main goal was to _remove_ a wrong entry. @gotmax23 objection to not having any named maintainers anymore and the (imho good) argument from the new maintainers that they would prefer to not have to maintain a static list of staff in multiple places lead to the suggestion to use a GitHub team.

TBH I’ve never looked into collection metadata who I could ping for a specific collection. So I could live with missing maintainers, or not having maintainers documented there at all.

> [@felixfontein](#):
>
> If you have other ideas, please mention them here!

I’ve started a discussion about [Machine-readable maintainers file in collections](https://github.com/ansible-community/community-topics/issues/100) once, but unfortunately that didn’t lead anywhere.

---

<div class="post-metadata">

**Author:** ![gotmax23](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gotmax23/32/106_2.png) [@gotmax23](https://forum.ansible.com/u/gotmax23)\
**Post date:** [December 6, 2023, 9:25pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/3 "2023-12-06T21:25:59Z")

</div>

> [@felixfontein](#):
>
> Use some automatism to update member lists automatically. This will likely only work for teams in Ansible controlled organizations. Also someone needs to set this up and maintain it.

I can work on this. In the meantime, I guess I’m fine with merging the vmware.vmware\_rest PR, but maybe let’s hold off on the other one that changes the rest of the cloud collections. _Perfect is the enemy of good_, and we can always adjust it later.

---

<div class="post-metadata">

**Author:** ![Andersson007](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/andersson007/32/89_2.png) [@Andersson007](https://forum.ansible.com/u/Andersson007)\
**Post date:** [December 7, 2023, 8:23am UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/4 "2023-12-07T08:23:44Z")

</div>

I would suggest removing the maintainers field from collection’s metadata entirely and forget about it.  
It’s not gonna actually work.  
you can’t be sure the lists are relevant , so we cannot rely on it.  
If we need to ping maintainers, we’ll just open an issue in a corresponding repo (what we always do).  
If there’s no response, the collection will get removed as maintainers responsiveness is a requirement.  
So I suggest removing unnecessary and unreliable entities.  
Maintainers should be interested in getting notified in a timely manner first of all, not SC or package release engineers should be interested in the maintainers being responsible.  
It’s not hard to press the “Watch → All activity” button once in life:)

---

<div class="post-metadata">

**Author:** ![mariolenz](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/mariolenz/32/108_2.png) [@mariolenz](https://forum.ansible.com/u/mariolenz)\
**Post date:** [December 7, 2023, 3:13pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/5 "2023-12-07T15:13:00Z")

</div>

> [@Andersson007](#):
>
> I would suggest removing the maintainers field from collection’s metadata entirely and forget about it.

I’ve never used this and don’t think I ever will, so 👍 from me.

---

<div class="post-metadata">

**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\
**Post date:** [December 7, 2023, 8:10pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/6 "2023-12-07T20:10:32Z")

</div>

I’m not sure what the `maintainers` field is in the collection metadata. Do you mean [https://github.com/ansible-community/ansible-build-data/blob/main/10/collection-meta.yaml](https://github.com/ansible-community/ansible-build-data/blob/main/10/collection-meta.yaml) and the similar files in the other directories?

---

<div class="post-metadata">

**Author:** ![Andersson007](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/andersson007/32/89_2.png) [@Andersson007](https://forum.ansible.com/u/Andersson007)\
**Post date:** [December 8, 2023, 11:18am UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/7 "2023-12-08T11:18:08Z")

</div>

@felixfontein if the question is addressed to me, i think yes, i don’t remember the field to be in other places but who knows

---

<div class="post-metadata">

**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\
**Post date:** [December 9, 2023, 9:22pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/8 "2023-12-09T21:22:54Z")

</div>

Ok. In any case I strongly disagree. We use this field to keep track of the maintainers mentioned in the initial inclusion application, and update it if possible. This allows us to ping who last officially was responsible for the collection. Obviously it might not be longer up to date, but it’s better than not having any contact.

(Even if this field would be part of the collection itself, it wouldn’t be much more trustworthy.)

---

<div class="post-metadata">

**Author:** ![Andersson007](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/andersson007/32/89_2.png) [@Andersson007](https://forum.ansible.com/u/Andersson007)\
**Post date:** [December 14, 2023, 1:57pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/9 "2023-12-14T13:57:13Z")

</div>

@felixfontein i’m not strongly against of having it as it doesn’t hurt, though i don’t understand why we should care if they don’t care:)  
The primary interested party in keeping their stuff included and resp responding to issues imo should be the maintainers, not the release engineers or SC.  
Moreover, I think it can hurt actually, e.g. when you ping irrelevant people in issues (which can lost their work emails after quitting their companies), the other, relevant maintainers, can skip the stuff thinking those issues are addressed to someone else:) It’s safer to go directly to repos and raise issues there just for maintainers than to ping certain people in other places like, e.g. here.  
I don’t think it’s a big deal though, so not strongly against of continuing to have that metadata field:)

---

<div class="post-metadata">

**Author:** ![gotmax23](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gotmax23/32/106_2.png) [@gotmax23](https://forum.ansible.com/u/gotmax23)\
**Post date:** [October 9, 2024, 6:29pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/10 "2024-10-09T18:29:23Z")

</div>

Can we make it possible to list teams in one place within the collection-meta file and then reference those teams within the collections entries so we don’t have to repeat the maintainers but all the information is still in one place?

---

<div class="post-metadata">

**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\
**Post date:** [October 9, 2024, 6:57pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/11 "2024-10-09T18:57:17Z")

</div>

You mean similar to good old BOTMETA.yml? (For example [community.general/.github/BOTMETA.yml at main · ansible-collections/community.general · GitHub](https://github.com/ansible-collections/community.general/blob/main/.github/BOTMETA.yml#L130) → [community.general/.github/BOTMETA.yml at main · ansible-collections/community.general · GitHub](https://github.com/ansible-collections/community.general/blob/main/.github/BOTMETA.yml#L1538))

---

<div class="post-metadata">

**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\
**Post date:** [October 9, 2024, 7:18pm UTC](https://forum.ansible.com/t/collection-maintainer-information-for-collections-included-in-ansible/2562/12 "2024-10-09T19:18:19Z")

</div>

What I forgot to write: Yes, sure, that’s definitely possible. The maintainer information isn’t used right now by the automated tools, so a simple schema change in antsibull-core should suffice.
