Contributing to rTASSELSource:
Thank you for taking time to contribute!
rTASSEL is an open source project and is maintained by a small team, we encourage interested members of the research community to seek out issues and propose changes where needed. In this document, we detail outlines to how you may contribute to the
You can fix typos, spelling mistakes, or grammatical errors in the documentation directly using the GitHub web interface, as long as the changes are made in the source file. Since we use
roxygen2 for document generation, please alter only typos found in
.R files and not
roxygen2 comments can be identified within
.R files with the
Bigger changes and bug reporting
If you want to make a bigger change, it’s a good idea to first file an issue and make sure someone from the team agrees that it’s needed. If you’ve found a bug, please file an issue that illustrates the bug with a minimal reprex (this will also help you write a unit test, if needed).
Submitting a pull request
rTASSELpackage from GitHub and clone onto your computer. If you are not familiar with
usethispackage provides a series of
git-based methods to help you out. For forking, you can use:
usethis::create_from_github("maize-genetics/rTASSEL", fork = TRUE)
From this fork, make sure you have all dependencies installed for
rTASSEL. This can be accomplished using
Once all dependencies are installed, run an
R CMDcheck using either RStudio’s integrated check features under the “Build” tab, or by running
devtools::check()in the console.
If build check does not fail, create a Git branch for your pull request (PR). The
usethispackage has a method for this that you may wish to use:
Make your changes, commit to git, and then create a PR by running
git-related commands/software, and following the prompts in your browser. Please provide a descriptive PR. Your PR should have the following:
- Descriptive title (briefly document the change)
- What number does this PR fix? Please provide this in the body of the PR with the language
Fixes #<issue number>.
If accepted, this will be documented in the NEWS material (
NEWS.md) with the next version update and acknowledgement of the user.
We try to follow the guidelines proposed by Bioconductor in terms of code style. When styling code, please only style your own code and not restyle code that falls out of your PR scope.
We use roxygen2, with Markdown syntax, for documentation.
- Please test your code! Like all good scientific projects, rigorous testing is a must. We use testthat for unit tests. Contributions with test cases included are easier to accept and will have higher priority for integration.
Code of Conduct
Please note that the rTASSEL project is released with a Contributor Code of Conduct. By contributing to this project you agree to abide by its terms.