Pull Requests

Fedora is running pagure on the top of its dist-git at https://src.fedoraproject.org.

Having pagure on the top of dist-git means you can use the fork/pull-request workflow. To use this workflow there are two situations to consider:

You are a packager

If you are a packager, you have ssh access to dist-git, so you can use pagure directly. Find the repository you would like to contribute to, fork it via the fork button at the top right. Wait a couple of minutes for the git repository and its access to be re-generated. Clone locally using the ssh URL and interact with this git repo as you would do normally.

You are NOT a packager

Contributors that are not in the packager group cannot ssh into dist-git. This is for security reasons and will not be changed.

However, pagure on dist-git supports now pushing via https.

For this you will need the fedpkg package:

sudo dnf install fedpkg

To push via https, your git repository needs to be configured in a certain way (i.e. you need to have a [credential] section in your .git/config). There are two ways you can have this.

Clone your git repo using
```
fedpkg clone -a
```
for example:
```
fedpkg clone -a forks/pingoufpca/rpms/fedora-gather-easyfix
```
In this case fedpkg will take care of setting up correctly your git repository allowing you to push using
```
git push
```
Clone your git repo using
```
git clone https://...
```
and push using
```
fedpkg push
```
Here as well, fedpkg will take care of configuring correctly your git repository.

Username/Password
If you ever see the CLI asking you for an username and/or password, your git repo is not correctly configured. The only place that should be asking you for an username and password is https://id.fedoraproject.org

fork(s)
The URL used for web browsing uses "fork/" (singular) while the path used for git uses "forks/" (plural).

Open a pull-request

Once you have pushed your commits to your fork, you can navigate to your fork in the UI and open the pull-request using either the New PR button appearing next to the branch you pushed into or on the main page of the project.

Working with Pull Requests
You may encounter a situation where you want to include changes from the master branch that were made after you created your pull request. Follow the article Working with Pull Requests

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