Skip to content

Latest commit

 

History

History
42 lines (29 loc) · 3.11 KB

CONTRIBUTING.md

File metadata and controls

42 lines (29 loc) · 3.11 KB
Raw

Contributing

Development is a community effort, and we welcome participation.

Code of Conduct

By participating in this project, you agree to abide by the code of conduct.

Discussions

At https://github.com/ropensci-books/targets/discussions, you can post general questions, brainstorm ideas, and ask for help.

Issues

https://github.com/ropensci-books/targets/issues is for bug reports, performance issues, maintenance tasks, and feature requests. When you post, please abide by the following guidelines.

  • Before posting a new issue, please take a moment to search for existing similar issues in order to avoid duplication.
  • For bug reports: if you can, please install the latest GitHub version of targets (i.e. remotes::install_github("ropensci/targets")) and verify that the issue still persists.
  • Describe your issue in prose as clearly and concisely as possible.
  • Include diagnostic details about the problem, including
    • A reproducible example.
    • Session info, available through sessionInfo() or reprex(si = TRUE).
    • A stack trace from traceback() or rlang::trace_back().
    • The SHA-1 hash of the GitHub commit of targets currently installed. packageDescription("targets")$GithubSHA1 shows you this.

Development

External code contributions are extremely helpful in the right circumstances. Here are the recommended steps.

  1. Prior to contribution, please propose your idea in a new issue thread so you and the maintainer can define the intent and scope of your work.
  2. Fork the repository.
  3. Follow the GitHub flow to create a new branch, add commits, and open a pull request.
  4. Discuss your code with the maintainer in the pull request thread.
  5. If everything looks good, the maintainer will merge your code into the project.

Please also follow these additional guidelines.

  • Respect the architecture and reasoning of the project.
  • If possible, keep contributions small enough to easily review manually. It is okay to split up your work into multiple pull requests.
  • Format your code according to the tidyverse style guide and check your formatting with the lint_package() function from the lintr package.
  • Describe your contribution in the project's NEWS.md file. Be sure to mention relevent GitHub issue numbers and your GitHub name as done in existing news entries.
  • If you feel contribution is substantial enough for official author or contributor status, please add yourself as an author in the index.Rmd file and `DESCRIPTION file.