gfwr is an open source project and we welcome contributions of multiple kinds: bug reports, fixes to bugs, typos, improvements to documentation, new functions.
By contributing, you agree that we may redistribute your work under our license. In exchange, we will address your issues and/or assess your change proposal as promptly as we can, and welcome you as a member of our community. Everyone involved in gfwr agrees to abide by our code of conduct.
The easiest way to get started is to file an issue to tell us about a spelling mistake, some awkward wording, or a bug. This allows us to assign the item to someone and to respond to it in a threaded discussion.
If you are comfortable with Git and would like to add or change material, you can submit a pull request (PR).
develop branch.develop branch.devtools::check()
If you do not have a GitHub account, you can send us comments by email to research@globalfishingwatch.org.
You can fix typos, spelling mistakes, or grammatical errors in the documentation directly with a PR to branch develop. This generally means you’ll need to edit roxygen2 comments in the .R file, not the .Rd file. Please do not commit the .Rd file, all documentation will be generated by us in the develop branch.
You can also use options 1 or 3 in the previous section
You may think that some functions are not clear enough and have suggestions to improve the documentation of the package. Here you’ll also need to file an issue. You can also edit roxygen2 comments in the corresponding .R file and file a PR. Please do not commit .Rd files, we will document the changes for you.
If you’ve found a bug, first create a minimal reproducible example (reprex). Spend some time trying to make it as minimal as possible: the more time you spend doing this, the easier it will be for the gfwr team to fix it. Use the sample shapefile or send the code to create the sf object when possible. If the example requires the use of your shapefile file please send it along so we can reproduce the error.
If you see a bug report in an issue and know how to fix it, please share your solution in the issue. If you can do a PR that would fix the issue, please do so and let us know in the issue.
The gfwr package has been developed to help the R community access Global Fishing Watch data for research and other applications. If you have ideas of new functions that are consistent with this aim, please let us know through email, an issue, or a proposal with a PR. If you would like to write the function but prefer to chat about it first with us, you can open an issue and start the conversation before doing a PR.
Remember that this package is a wrapper for an API, so we do not intend to add functions to plot or analyze data. That would be out of the scope of the package.
If you are interested in collaborating with us to generate such a package, please get in touch. Otherwise, you are welcome to create a package with functions out of the scope of this one by yourself. We are happy to see other people making contributions for the community based on our work.
(This contributing guide is an adaptation of the Carpentries, tidyverse, and unifr contributing guides.)