OpenHands icon indicating copy to clipboard operation
OpenHands copied to clipboard

Add contributors list

Open powerzbt opened this issue 1 year ago • 9 comments

Categorize the contributions of contributors in a way that supports and encourages further contributions.

powerzbt avatar Mar 28 '24 05:03 powerzbt

Is there a way to automate this update?

huybery avatar Mar 28 '24 11:03 huybery

+1 love the idea, but we should have a script to keep it updated

rbren avatar Mar 28 '24 19:03 rbren

@powerzbt how did you generate this?

rbren avatar Mar 29 '24 19:03 rbren

+1 love the idea, but we should have a script to keep it updated

I am working on this. thank you for your vote.

powerzbt avatar Mar 29 '24 21:03 powerzbt

@powerzbt how did you generate this?

Based on contributor's commit history

powerzbt avatar Mar 29 '24 21:03 powerzbt

ahh you wrote it by hand? 👍

rbren avatar Mar 29 '24 23:03 rbren

ahh you wrote it by hand? 👍

yeah 🥹

powerzbt avatar Mar 30 '24 02:03 powerzbt

I don't really know how to do this but I think you can do it with Github Actions.

Here is a summary of the key points:

To effectively manage and recognize contributors in a GitHub repository, the following approaches can be used:

  1. Automation using GitHub Actions:

    • Create a workflow file to automatically update the contributors list when new contributions are made.
    • Utilize pre-built actions like "all-contributors" to list and categorize contributors.
  2. Categorizing contributions:

    • Use the "All Contributors" specification to recognize contributions across different categories (e.g., code, documentation, design).
    • Leverage the "all-contributors" bot or action to maintain the categorization automatically.
  3. Custom script for updating the contributors list:

    • Write a script that uses the GitHub API to retrieve the list of contributors and their contributions.
    • Update the contributors list in a file (e.g., CONTRIBUTORS.md) based on your categorization logic.
    • Integrate the script into a GitHub Actions workflow.
  4. Encouraging further contributions:

    • Ensure the contributors list is prominently displayed in the project (e.g., in the README.md file) to show appreciation.
    • Consider including personalized acknowledgments or highlights for special contributions in project updates or newsletters.

The key benefits of these approaches are to save time, keep the recognition of contributors up-to-date, and foster a culture of appreciation and engagement within the project community.

PierrunoYT avatar Mar 30 '24 19:03 PierrunoYT

There are a handful of utilities out there that automate this, e.g. https://github.com/mgechev/github-contributors-list

I think we just need to pick one and integrate it. Even if someone needs to run it by hand occasionally. But e.g. a github action that runs nightly would be 🥇

rbren avatar Mar 30 '24 23:03 rbren

@powerzbt I'm going to close this, but if you find a way to automate it let us know!

rbren avatar Apr 02 '24 22:04 rbren