-
-
Notifications
You must be signed in to change notification settings - Fork 372
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
Add contributors to AUTHORS #1460
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for getting this discussion started.
I have absolutely no problem with crediting anyone who has contributed to any BeeWare project. I'm 100% in favor of anything that improves the way we surface the efforts of contributors.
I don't think removing the AUTHORS file is a good option. It's enough of a social convention that we should have something here. I completely agree that the current file isn't well worded, though.
In terms of this specific implementation, I have some concerns:
- Keeping the list up to date, and in the process making our contribution process more complex by adding an "add your name to the contributor file". We have enough issues getting people to add a changenote file.
- While this is all based on public information from the GitHub log, I'm wary about auto-adding an easily visible manifestation. Some people may not want the credit; others may want the credit under a different name (e.g., deadnaming trans folk, people who use pseudonyms that don't match their GitHub login); and in some cases, people have multiple entries (I noticed Ellie Graves/elliegraves; I'm betting there are others).
- Ordering. AFAICT, this is based on number of commits; however, there are people high on this list because they took 5 commits to get the spelling right on a variable name; others regularly rebase and squash multi-file contributions. Ordering by number of commits also undermines the "all commits are valued" narrative. If we're going down this list, I'd rather see alphabetical ordering (with the added benefit that this is an easier ordering to keep accurate over time).
- It misses (and undervalues) non-code contributions. Someone who spends their evenings in the Discord room telling people to run
briefcase update -r
won't get any credit on this list.
Whatever the outcome of the discussion on the specific form: I think you (plus Malcolm and Dan) qualify as primary maintainers at this point :-) Going by people who have commit access, Sagi, Sam, Asheesh and Katie should be on that list too. However, we should confirm with each of them that they're comfortable with being added to a primary maintainers list before adding them in that capacity.
I agree with these points and expected them as they are germane.
I agree with this....but it may be worth pointing out that GitHub already provides a prominent link to such a list via contributors on the repo's landing page. What about these next steps?
|
That sounds like a plan to me. |
Should we add contributors to the
AUTHORS
file? Or should we just get rid of it?Quick one-liner to update
AUTHORS
file:PR Checklist: