How to make a pull request?
You will need to submit your contributions in the form of pull requests to the unstable branch of the TRIQS repository, and this page is here to guide you through this process.
Setting up your fork repository
First, go to the triqs github, and click the Fork button at the top right of the screen. This creates your own copy of the TRIQS repository. If you go to your account page, you see that you now have a new repository, forked from TRIQS/triqs.
Go to your local TRIQS source directory:
git remote -v
You should be seeing the following:
origin https://github.com/TRIQS/triqs.git (fetch) origin https://github.com/TRIQS/triqs.git (push)
Now, add your version of TRIQS:
git remote add my_triqs https://github.com/YOUR_USERNAME/triqs.git
git remote -v
my_triqs https://github.com/YOUR_USERNAME/triqs.git (fetch) my_triqs https://github.com/YOUR_USERNAME/triqs.git (push) origin https://github.com/TRIQS/triqs.git (fetch) origin https://github.com/TRIQS/triqs.git (push)
git remote update git fetch --all
If you now type the following command:
git branch --all
you see all the branches, both from the original repository and your own fork.
Congratulations, you’re all set! You can learn more about forks here and here. This page explains how to keep your fork synced to the original repository.
Making your pull request
Start by moving to the unstable branch of the TRIQS repository and get the latest commits:
git checkout unstable git pull
From here, create the branch where your pull request will live:
git branch my_first_PR git checkout my_first_PR
You can now work on this branch as usual, modifying files and committing your changes. Keep in mind to push your branch to your fork:
git push my_triqs my_first_PR
Please keep in your commit messages clear and concise, using brackets to specify what you are modifying (for instance [doc] if you contribute to the documentation, [det_manip] if you fix a bug in the det_manip class, etc.). Do not multiply your commits, or squash them before doing your pull request (see for example this page).
When you consider your pull request ready to be reviewed by TRIQS developers, go to the github page of your fork and click New pull request. Be sure to select unstable as the target branch and my_first_PR as the source branch. If you experience any issue, you can refer to the github help.
Thank you for contributing to TRIQS!