Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Names and definitions of people -- standardize language in metrics #113

Open
GeorgLink opened this issue Apr 2, 2021 · 4 comments
Open
Labels
I: discussion Open discussion for new ideas and thoughts

Comments

@GeorgLink
Copy link
Member

GeorgLink commented Apr 2, 2021

While defining metrics, we use a variety of different names including: people, members, contributors, authors, submitters, reviewers, observers, developers, committers, maintainers, and users.

I think it would be great to have a definition of each and make sure we use them consistently across all CHAOSS metrics -- ergo I think this a task for the Common WG.

Most relevant metrics:

@GeorgLink
Copy link
Member Author

Here is how Cauldron defines some of these:

  • People: I don’t remember having this concept in Cauldron, but I think it may refer to the set of all the other concepts you’ve named.
  • Submitters: They are those people who have contributed to a project by opening an issue or a PR / MR.
  • Authors: They are those people who have contributed to a project generating commits.
  • Maintainers: It is the name we used to give to what is currently known as Submitters (reviews).
  • Contributors: It is the name that we used to give to what is currently known as Authors.
  • Users: It is the name we used to give to what is now known Attendees (Meetup).
  • Observers: It is the name we used to give to what is currently known as Submitters (issues).

Source: https://community.cauldron.io/t/what-are-submitters-authors-maintainers-contributors-users-and-observers/122/2?u=georglink

@GeorgLink GeorgLink added the I: discussion Open discussion for new ideas and thoughts label Apr 2, 2021
@geekygirldawn
Copy link
Member

Need to better understand overlap and duplication with the handbook: https://handbook.chaoss.community/community-handbook/about/terminology/chaoss-committees

Should these really be metrics that we link to that contain the definitions? Rather than trying to maintain a separate glossary.

@GeorgLink
Copy link
Member Author

I am okay with both options of either (a) defining the terms through a glossary or (b) creating a metric for each. Metrics are more work to create.

A glossary could live in the handbook and then be included in all metric releases..

@ElizabethN
Copy link
Member

Just a point of note, we have had feedback from newcomers that some of our own internal terms are also confusing ("working group", for example) so maybe a glossary would still be helpful.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
I: discussion Open discussion for new ideas and thoughts
Projects
None yet
Development

No branches or pull requests

3 participants