Skip to content

Latest commit

 

History

History
74 lines (48 loc) · 4.54 KB

CONTRIBUTING.md

File metadata and controls

74 lines (48 loc) · 4.54 KB

How to contribute to NARPS Open Pipelines ?

For the reproductions, we are especially looking for contributors with the following profiles:

  • 👩‍🎤 SPM, FSL, AFNI or nistats has no secrets for you? You know this fMRI analysis software by heart 💓. Please help us by reproducing the corresponding NARPS pipelines. 👣 after step 1, follow the fMRI expert trail.
  • 🧑‍🎤 You are a nipype guru? 👣 after step 1, follow the nipype expert trail.

Step 1: Choose a pipeline to reproduce ⌨️

🤔 Not sure which pipeline to start with ? 🚦The pipeline dashboard provides the progress status for each pipeline. You can pick any pipeline that is in red (not started).

Need more information to make a decision? The narps_open.utils.description module of the project, as described in the documentation provides easy access to all the info we have on each pipeline.

When you are ready, start an issue and choose Pipeline reproduction!

Step 2: Reproduction

🧑‍🎤 NiPype trail

We created templates with modifications to make and holes to fill to create a pipeline. You can find them in narps_open/pipelines/templates.

If you feel it could be better explained, do not hesitate to suggest modifications for the templates.

Feel free to have a look to the following pipelines, these are examples :

team_id softwares fmriprep used ? pipeline file
2T6S SPM Yes /narps_open/pipelines/team_2T6S.py
X19V FSL Yes /narps_open/pipelines/team_X19V.py

👩‍🎤 fMRI software trail

...

Find or propose an issue 📋

Issues are very important for this project. If you want to contribute, you can either comment an existing issue or proposing a new issue.

Answering an existing issue 🏷️

To answer an existing issue, make a new comment with the following information:

  • Your name and/or github username
  • The step you want to contribute to
  • The approximate time needed

Proposing a new issue 💡

In order to start a new issue, click here and choose the type of issue you want:

  • Feature request if you aim at improving the project with your ideas ;
  • Bug report if you encounter a problem or identified a bug ;
  • Classic issue to ask question, give feedbacks...

Some issues are (probably) already open, please browse them before starting a new one. If your issue was already reported, you may want complete it with details or other circumstances in which a problem appear.

Pull Requests 📥

Pull requests are the best way to get your ideas into this repository and to solve the problems as fast as possible.

Make A Branch 🌳

Create a separate branch for each issue you're working on. Do not make changes to the default branch (e.g. master, develop) of your fork.

Push Your Code 📤

Push your code as soon as possible.

Create the Pull Request (PR) 📥

Once you pushed your first lines of code to the branch in your fork, visit this page to start creating a PR for the NARPS Open Pipelines project.

⚠️ Please create a Draft Pull Request as described here, and please stick to the PR description template as much as possible.

Continue writing your code and push to the same branch. Make sure you perform all the items of the PR checklist.

Request Review 🥸

Once your PR is ready, you may add a reviewer to your PR, as described here in the GitHub documentation.

Please turn your Draft Pull Request into a "regular" Pull Request, by clicking Ready for review in the Pull Request page.

👋 Thank you in advance for contributing to the project!

Additional resources

  • git and Gitub: general guidelines can be found here in the GitHub documentation.