Using github for Infra Projects

We’re presently using github to host git repositories and issue tracking for some infrastructure projects. Anything we need to know should be recorded here.

Setting up a new repo

Create projects inside of the fedora-infra group:

https://github.com/fedora-infra

That will allow us to more easily track what projects we have.

projects can be added by request in a infra ticket.

  • After creating a new repo, click on the Settings tab to set up some fancy things.

    If using git-flow for your project:

    • Set the default branch from main to develop. Having the default branch be develop is nice: new contributors will automatically start committing there if they’re not paying attention to what branch they’re on. You almost never want to commit directly to the master branch.

      If there does not exist a develop branch, you should create one by branching off of master:

      $ git clone GIT_URL
$ git checkout -b develop
$ git push --all

2fa

All users added to fedora-infra github projects should have 2 factor auth enabled in their account.

Want to help? Learn how to contribute to Fedora Docs ›