Contributing to Codeberg 🩵

Do you want to get involved in Codeberg? Thank you so much! Read on to learn how you can help.

Getting Started

We recommend performing the following steps. Each one is optional and can be skipped.

• Join our Contributing to Matrix room chat (Matrix is a federated messaging protocol). Smalltalk is a good way to get to know the team and your potential next colleagues. Most communication within Codeberg happens on Matrix.
• Browse the open issues in this repository to get an idea of interesting projects. Comment in some if you would like to join, or take a deep dive into their resources and chats right away.
• Create a new issue to introduce yourself. If there are blockers that prevent you from getting started, or if you have different interests than the existing team list, let us know!

Finding interesting work

Browse the open issues here and check if a team interests you. Use the labels to filter the expectations. Sometimes, we need someone to lead an effort and build a team. Often, you can join an existing effort and collaborate with others already.

The pinned issues highlight some projects that are either very active or forming right now. Check them out in any case!

If something is unclear, don't be shy and add a comment asking for more information.

If you didn't find something that matches your interests, please let us know if you have ideas on your own. Codeberg's community maintenance allows you to work on things you are interested in. Maybe it's a cool idea we didn't think about before.

Inexperienced? Don't worry!

Many people feel like they cannot keep pace with an organization of the size of Codeberg. But it's actually the opposite: Codeberg is what it is due to the diverse nature of our contributors. We are sure there is a place for you!

Codeberg does not only need Designers, User Experience experts, frontend and backend developers, system administrators and communication managers. We also need people who can help us connect the domains by bringing in new perspectives.

For some of our current core team members, Codeberg was also a great learning opportunity. It allowed them to dive into topics they were interested in, and make rapid experiences therein. If you want to learn, please get in touch and we'll try to ensure you'll find a productive environment to extend your skills.

Get help when you are stuck

Take a break from what you are doing and get your head free. Then try to organize your thoughts, break your problem down, and chat with others about the problem (for example in the Matrix room or in your issue).

If this doesn't help you, or you have dependencies (hardware, permissions etc) or you can't figure out how to continue, you can usually ping one of these people:

• @fnetX (Matrix)
• @Gusted (Matrix)

They can help you figure out where to continue.

Start a new project

Something is missing? You want to help? Great! If there is no issue yet, propose a new team in the issue tracker. Explain that you want to take the lead.

To prevent projects from going stale once a person loses interest or other circumstances prevent them from continuing their work, we usually want to have at least two maintainers. Please help us in finding a second person for your project by actively asking for help in the issue and chatrooms.

Some of our projects

You can find more teams in the issue tracker. This list adds a few information about the most relevant teams.

Active Software Projects

Community Projects

These projects do not necessarily require coding experience, but benefit from other things like community management, writing or Public Relations Experience.

Infrastructure Projects

Some of these require certain access levels to Codeberg's infrastructure. If you are interested and commit a certain amount of time, this can surely be talked about. Please see the "Limitations" sections.

In case of upstream projects, maintaining the service also includes collecting and forwarding bug reports to upstream development.

Many of the scripts that we use to host Codeberg can be found in a specially designated organization.