Cloudberry Database community welcomes contributions from anyone, new and experienced! We appreciate your interest in contributing. This guide will help you get started with the contribution.

Code of Conduct​

Everyone who participates in Cloudberry Database, either as a user or a contributor, is obliged to follow our community Code of Conduct. Every violation against it will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The moderator team is obligated to maintain confidentiality regarding the reporter of an incident.

Some behaviors that contribute to creating a positive environment include:

• Use welcoming and inclusive language.
• Respect differing viewpoints and experiences.
• Accept constructive criticism gracefully.
• Foster what's best for the community.
• Show empathy for community members.

Find a Way to Contribute​

There are many ways to contribute to Cloudberry Database. Here are some ways you need to get started. The most common contributions include code, documentation, and community support.

You can participate by:

• Contributing code.
• Improving documentation.
• Helping out in the Slack channels, see Slack Guide.
• Answering questions on GitHub Discussions.
• Investigating GitHub issues.
• Reporting a new bug.
• Sharing ideas for new features.
• Helping review Pull Requests or Proposals.
• Proposing your proposal, see Proposal Guide.
• Reporting security issues.
• Testing code, testing releases.
• Creating educational content (Blog posts, tutorials, videos, etc.)
• Spreading the word about Cloudberry Database on social media(eg, Twitter, LinkedIn).
• ...
• More things to make Cloudberry Database better.

Getting Help​

Feel free to reach out to us in Slack #dev channels or GitHub Discussions when your contribution is blocked, especially when making your first contribution. Don't be shy, we're happy to help.

As the next-generation unified database, Cloudberry Database cannot grow without the support from the community. Hope to make our mission with you!

Benefits of Contribution​

There are many reasons to contribute to Cloudberry Database and open source projects in general. Here are some of the benefits of participating:

• Growing your network. Working with Cloudberry Database in open source can help connect you with people working on similar things. You can get help or give help, and you might even make a real-life acquaintance!

• Improving your skills. When you work on a Cloudberry Database issue or Pull Request, inevitably you'll learn more about how something works in our project; either by asking questions and gathering info or by digging deeper into the code yourself. There’s a skill-building benefit to contributing to open source projects.

• Becoming an expert. You might start new to a project like Cloudberry Database or PostgreSQL, and by building things and opening issues when you encounter a new challenge or a bug, you’ll learn a ton over time. You could find your knowledge of said project has grown so much that you’ve become an expert.

• Speaking at conferences or more community events. With those skills you’ve earned yourself working in open source, you can let other people hear from you, and build your professional reputation through these community activities.

• Getting free swag! By participating in GitHub and other community channels, you can become eligible for free swag that the Cloudberry Database team offers as a way to say thank you.

There are undoubtedly more benefits than those listed here. Hope you enjoy your contribution to the Cloudberry Database community!