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

Enhance README: Shields to capture the attention of potential contributors #49

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

devactivity-team
Copy link

I noticed you have opened issues labeled help wanted. I recommend enhancing the README to make the call for new contributors more prominent.

Changes Made:

  1. Shields: Added Shields.io badges at the top of the README

GitHub repo Good Issues for newbies GitHub Help Wanted issues GitHub Help Wanted PRs GitHub repo Issues

[![GitHub repo Good Issues for newbies](https://img.shields.io/github/issues/valtiojs/valtio-yjs/good%20first%20issue?style=flat&logo=github&logoColor=green&label=Good%20First%20issues)](https://github.com/valtiojs/valtio-yjs/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) [![GitHub Help Wanted issues](https://img.shields.io/github/issues/valtiojs/valtio-yjs/help%20wanted?style=flat&logo=github&logoColor=b545d1&label=%22Help%20Wanted%22%20issues)](https://github.com/valtiojs/valtio-yjs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) [![GitHub Help Wanted PRs](https://img.shields.io/github/issues-pr/valtiojs/valtio-yjs/help%20wanted?style=flat&logo=github&logoColor=b545d1&label=%22Help%20Wanted%22%20PRs)](https://github.com/valtiojs/valtio-yjs/pulls?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) [![GitHub repo Issues](https://img.shields.io/github/issues/valtiojs/valtio-yjs?style=flat&logo=github&logoColor=red&label=Issues)](https://github.com/valtiojs/valtio-yjs/issues?q=is%3Aopen)
  1. Welcoming Message: Enhanced the README with a more prominent and inviting message to welcome new contributors.

Why This Matters:

  • Attract New Contributors: Considering there is a number of opened issues labeled 'Help Wanted' - a welcoming and appealing README is one of the most efficient ways to attract new contributors

Additional Resources:

For more insights into building a strong open-source community, check out the Building Community guide.

🚀 Thank you for considering this pull request! 🚀

@devactivity-team
Copy link
Author

I also suggest enhancing the README with the following widgets using devActivity app:

1. Dynamic Top Contributors (with avatars linked to contributor profiles)

devActivity Top Contributors Widget

2. Repo Stats

devActivity Repo Stats Widget

Feel free to explore the Live Demo and Public Dashboard for a quick overview of the app.
It makes the contribution process more exciting with gamification elements like:

  • 🌟 XP and Levels based on contributions
  • 🏆 Challenges and Achievements
  • 🏅 Leaderboard and much more!

devActivity Leaderboard

Latest repositories using devActivity: barecheck (⭐55)


Simply install an app to bring a more comprehensive and engaging community experience.

🌟 Happy Coding! 🌟

Copy link

codesandbox-ci bot commented Jul 7, 2024

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.


## Contributing

[![GitHub repo Good Issues for newbies](https://img.shields.io/github/issues/valtiojs/valtio-yjs/good%20first%20issue?style=flat&logo=github&logoColor=green&label=Good%20First%20issues)](https://github.com/valtiojs/valtio-yjs/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) [![GitHub Help Wanted issues](https://img.shields.io/github/issues/valtiojs/valtio-yjs/help%20wanted?style=flat&logo=github&logoColor=b545d1&label=%22Help%20Wanted%22%20issues)](https://github.com/valtiojs/valtio-yjs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) [![GitHub Help Wanted PRs](https://img.shields.io/github/issues-pr/valtiojs/valtio-yjs/help%20wanted?style=flat&logo=github&logoColor=b545d1&label=%22Help%20Wanted%22%20PRs)](https://github.com/valtiojs/valtio-yjs/pulls?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) [![GitHub repo Issues](https://img.shields.io/github/issues/valtiojs/valtio-yjs?style=flat&logo=github&logoColor=red&label=Issues)](https://github.com/valtiojs/valtio-yjs/issues?q=is%3Aopen)
Copy link
Member

Choose a reason for hiding this comment

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

I like using img.shelds.io as we already use it, but in general, I don't think it's super important or necessary for getting helps.

Thanks for your suggestion. Let's see for a while if we get more comments on it from others before closing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants