You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/CONTRIBUTING.md
+10-3Lines changed: 10 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -25,15 +25,22 @@ You may also wish to contact the development team for bigger changes. Please see
25
25
* Install all development dependencies with `devtools::install_dev_deps()`, and then make sure the package passes R CMD check by running `devtools::check()`.
26
26
If R CMD check doesn't pass cleanly, it's a good idea to ask for help before continuing.
27
27
28
-
* Create a Git branch for your pull request (PR). We recommend using `usethis::pr_init("brief-description-of-change")`. This is important: even for team members, please make commits to branches, first.
28
+
* Create a Git branch for your pull request (PR). We recommend using `usethis::pr_init("brief-description-of-change")`. This is important: **even for team members, please make commits to branches, first**.
29
29
30
-
* Ensure that all checks are passing. You can see this information within your PR. If a check is not passing, correct the issue or contact a package maintainer for help.
30
+
* Ensure that all checks are passing. You can see this information within your PR (on GitHub). It will say passing or failing, and if failing, you can see what is the cause. If a check is not passing, correct the issue or contact a package maintainer for help.
31
31
32
-
* Please run `goodpractice::gp()` to ensure code quality compliance. Some markers from this can justifiably be ignored, whereas others must be addressed. See a discussion [here](https://github.com/konfound-project/konfound/issues/50)
32
+
* Please run `goodpractice::gp()` to ensure code quality compliance. Some markers from this can justifiably be ignored, whereas others must be addressed. See a discussion [here](https://github.com/konfound-project/konfound/issues/50). Some things to be aware of:
33
+
* avoiding long code lines (more than 80 characters)
34
+
* using TRUE and FALSE instead of T and F
35
+
* using roxygen2 syntax to import specific functions from packages
36
+
* avoiding functions that are overly complex (i.e., avoiding high cyclomatic complexity)
37
+
38
+
* For new functions or functionality, write examples and tests to cover the core of the functionality. Aim for 80% or higher test coverage for new functions. Check with `covr::package_coverage()`.
33
39
34
40
* Make your changes, commit to git, and then create a PR by running `usethis::pr_push()`, and following the prompts in your browser.
35
41
The title of your PR should briefly describe the change.
36
42
The body of your PR should contain `Fixes #issue-number`.
43
+
37
44
* A member of the team will then review your PR.
38
45
39
46
* For user-facing changes, add a bullet to the top of `NEWS.md` (i.e. just below the first header). Follow the style described in <https://style.tidyverse.org/news.html>.
0 commit comments