openSUSE:GitHub

Jump to: navigation, search

If you are coming from GitHub and would like to learn more about openSUSE in general, please proceed to the openSUSE home page

openSUSE uses GitHub to host the source code of some of the software used as part of or to create the openSUSE distribution. See the openSUSE's profile on GitHub for the full list.

Here are some guidelines for managing the openSUSE projects on GitHub:

  • All code related to openSUSE is welcome to be part of the openSUSE organization on GitHub. If you have a new project, you would like to be included on GitHub, write to the public opensuse-project@opensuse.org mailing list, so we can include you.
  • We also welcome hosting of forks of upstream projects in the github.com/openSUSE organisation. Ideally, these forks should be used to act as 'aggregators' of contributions, to ease submissions from openSUSE to their respective upstream. Packaging from such openSUSE-hosted forks should be avoided unless absolutely necessary.
  • If you would like to contribute to an existing openSUSE project on GitHub, start with forking the repository and providing your patches as pull requests. Then maintainers can review them, give feedback, and merge them in.
  • People maintaining projects, merging pull requests, or directly pushing to the main repository are usually part of the "openSUSE Committers" team, which has pull and push access to all repositories. If you want to be added or need somebody else to be added contact one of the owners of the openSUSE GitHub account or write to the opensuse-project@opensuse.org mailing list.
  • The "openSUSE Committers" team technically has push access to all repositories, but who is supposed to commit what is governed by the social contract between the contributors. In most cases there is a maintainer or a group of maintainers for a repository, which decides what gets committed and what the rules for committing are.
  • There are exceptions for some repositories, which need tighter access control, but usually new people should just be added to "openSUSE Committers". If you need an exception contact the owners or write to opensuse-project@opensuse.org.
  • The openSUSE account on GitHub is managed by the Owners team. This includes adding or removing users from other teams. The Owners team is a small group of core community members. It's enough people so there usually always is somebody around, but should be kept small to keep it easy to manage.