How to contribute#

Installation procedure (for developers)#

If you want to help maintaining and improving the tqecd package, you will need to install a few more packages than the regular installation. It is also recommended to use an editable installation.

# Clone the repository to have local files to work on
git clone https://github.com/tqec/tqecd.git
# Install the library with developer dependencies
python -m pip install -e 'tqecd[all]'
# Go in the tqec directory and enable pre-commit
cd tqecd
pre-commit install

You can now start contributing, following the rules explained in the next sections.

How to contribute#

1. Look at issues#

Start by looking at the issues list.

Pick one issue that you want to work on. We emphasize on want: this is an open source project, so do not force yourself to work on something that does not interest you.

2. Comment on one or more issues#

Once you have found one or more issue(s) you want to work on, send a comment on these issues to:

  1. make your interest public,

  2. ask for updates, as the issue might not be up-to-date.

One of the lead developers will come back to you and assign you the issue if

  1. nobody is already working on it,

  2. the issue is still relevant.

3. Create a specific branch for each issue#

If you are part of the tqec community, you will be able to create a branch directly in the tqec/tqecd repository. If you are not, you can fork the tqec/tqecd repository on your own account (click here) and create a branch there.

4. Work in your branch and submit a pull request#

You should only work on the branch you just created. Implement the fix you envisionned to the issue you were assigned to.

If, for personnal/professional reasons, lack of motivation, lack of time, or whatever the reason for which you know that you won’t be able to complete your implementation, please let us know in the issue so that we can un-assign you and let someone else work on the issue.

Once you think you have something that is ready for review or at least ready to be read by other people, you can submit a pull request (PR) on the main branch of the tqec/tqecd repository. In the PR message, try to provide as much information as possible to help other people understanding your code.

5. Merge the PR#

Once your code has been reviewed and accepted by at least one of the developers, you will be able to merge it to the main branch. You (the PR owner) are responsible to click on the “Merge” button. If you prefer someone else to do it, you should send a clear comment asking for it.