|
1 | 1 | # nf-core/sarek: Contributing Guidelines
|
2 | 2 |
|
3 |
| -Hi there! Many thanks for taking an interest in improving nf-core/sarek. |
| 3 | +Hi there! |
| 4 | +Many thanks for taking an interest in improving nf-core/sarek. |
4 | 5 |
|
5 |
| -We try to manage the required tasks for nf-core/sarek using GitHub issues, you probably came to this page when creating one. Please use the pre-filled template to save time. |
6 |
| - |
7 |
| -However, don't be put off by this template - other more general issues and suggestions are welcome! Contributions to the code are even more welcome ;) |
8 |
| - |
9 |
| -> If you need help using or modifying nf-core/sarek then the best place to ask is on the pipeline channel on [Slack](https://nf-core-invite.herokuapp.com/). |
| 6 | +We try to manage the required tasks for nf-core/sarek using GitHub issues, you probably came to this page when creating one. |
| 7 | +Please use the pre-filled template to save time. |
10 | 8 |
|
| 9 | +However, don't be put off by this template - other more general issues and suggestions are welcome! |
| 10 | +Contributions to the code are even more welcome ;) |
11 | 11 |
|
| 12 | +> If you need help using or modifying nf-core/sarek then the best place to ask is on the nf-core Slack [#sarek](https://nfcore.slack.com/channels/sarek) channel ([join our Slack here](https://nf-co.re/join/slack)). |
12 | 13 |
|
13 | 14 | ## Contribution workflow
|
14 |
| -If you'd like to write some code for nf-core/sarek, the standard workflow |
15 |
| -is as follows: |
16 | 15 |
|
17 |
| -1. Check that there isn't already an issue about your idea in the |
18 |
| - [nf-core/sarek issues](https://github.com/nf-core/sarek/issues) to avoid |
19 |
| - duplicating work. |
| 16 | +If you'd like to write some code for nf-core/sarek, the standard workflow is as follows: |
| 17 | + |
| 18 | +1. Check that there isn't already an issue about your idea in the [nf-core/sarek issues](https://github.com/nf-core/sarek/issues) to avoid duplicating work |
20 | 19 | * If there isn't one already, please create one so that others know you're working on this
|
21 |
| -2. Fork the [nf-core/sarek repository](https://github.com/nf-core/sarek) to your GitHub account |
| 20 | +2. [Fork](https://help.github.com/en/github/getting-started-with-github/fork-a-repo) the [nf-core/sarek repository](https://github.com/nf-core/sarek) to your GitHub account |
22 | 21 | 3. Make the necessary changes / additions within your forked repository
|
23 |
| -4. Submit a Pull Request against the `dev` branch and wait for the code to be reviewed and merged. |
24 |
| - |
25 |
| -If you're not used to this workflow with git, you can start with some [basic docs from GitHub](https://help.github.com/articles/fork-a-repo/) or even their [excellent interactive tutorial](https://try.github.io/). |
| 22 | +4. Submit a Pull Request against the `dev` branch and wait for the code to be reviewed and merged |
26 | 23 |
|
| 24 | +If you're not used to this workflow with git, you can start with some [docs from GitHub](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests) or even their [excellent `git` resources](https://try.github.io/). |
27 | 25 |
|
28 | 26 | ## Tests
|
29 |
| -When you create a pull request with changes, [Travis CI](https://travis-ci.org/) will run automatic tests. |
| 27 | + |
| 28 | +When you create a pull request with changes, [GitHub Actions](https://github.com/features/actions) will run automatic tests. |
30 | 29 | Typically, pull-requests are only fully reviewed when these tests are passing, though of course we can help out before then.
|
31 | 30 |
|
32 | 31 | There are typically two types of tests that run:
|
33 | 32 |
|
34 | 33 | ### Lint Tests
|
35 |
| -The nf-core has a [set of guidelines](http://nf-co.re/guidelines) which all pipelines must adhere to. |
| 34 | + |
| 35 | +`nf-core` has a [set of guidelines](https://nf-co.re/developers/guidelines) which all pipelines must adhere to. |
36 | 36 | To enforce these and ensure that all pipelines stay in sync, we have developed a helper tool which runs checks on the pipeline code. This is in the [nf-core/tools repository](https://github.com/nf-core/tools) and once installed can be run locally with the `nf-core lint <pipeline-directory>` command.
|
37 | 37 |
|
38 | 38 | If any failures or warnings are encountered, please follow the listed URL for more documentation.
|
39 | 39 |
|
40 | 40 | ### Pipeline Tests
|
41 |
| -Each nf-core pipeline should be set up with a minimal set of test-data. |
42 |
| -Travis CI then runs the pipeline on this data to ensure that it exists successfully. |
| 41 | + |
| 42 | +Each `nf-core` pipeline should be set up with a minimal set of test-data. |
| 43 | +`GitHub Actions` then runs the pipeline on this data to ensure that it exits successfully. |
43 | 44 | If there are any failures then the automated tests fail.
|
44 |
| -These tests are run both with the latest available version of Nextflow and also the minimum required version that is stated in the pipeline code. |
| 45 | +These tests are run both with the latest available version of `Nextflow` and also the minimum required version that is stated in the pipeline code. |
| 46 | + |
| 47 | +## Patch |
| 48 | + |
| 49 | +: warning: Only in the unlikely and regretful event of a release happening with a bug. |
| 50 | + |
| 51 | +* On your own fork, make a new branch `patch` based on `upstream/master`. |
| 52 | +* Fix the bug, and bump version (X.Y.Z+1). |
| 53 | +* A PR should be made on `master` from patch to directly this particular bug. |
45 | 54 |
|
46 | 55 | ## Getting help
|
47 |
| -For further information/help, please consult the [nf-core/sarek documentation](https://github.com/nf-core/sarek#documentation) and don't hesitate to get in touch on the [sarek pipeline channel](https://nfcore.slack.com/channels/sarek) on [Slack](https://nf-co.re/join/slack). |
| 56 | + |
| 57 | +For further information/help, please consult the [nf-core/sarek documentation](https://nf-co.re/sarek/docs) and don't hesitate to get in touch on the nf-core Slack [#sarek](https://nfcore.slack.com/channels/sarek) channel ([join our Slack here](https://nf-co.re/join/slack)). |
0 commit comments