CONTRIBUTING.md

In ellisvalentiner/lubridateExtras: Convenience Functions for Manipulating Datetimes

Contributing

lubridateExtras is an Open Source project and there are different ways to contribute.

Please, use GitHub issues to report errors/bugs or to ask for new features.

Contributions are welcome in the form of pull requests. Please follow these guidelines:

• Write code against the master branch but pull request against the dev branch.
• By making a pull request, you're agreeing to license your code under a MIT license.
• Code should be documented and tested.

Style

Function/variable naming & general syntax

• Use snake_case for function names.

• Avoid function names that conflict with base packages or other popular ones (e.g. ggplot2, dplyr, magrittr, data.table).

• Use an object_verb() naming scheme for functions that take a common data type or interact with a common API. object refers to the data/API and verb the primary action. This scheme helps avoid namespace conflicts with packages that may have similar verbs, and makes code readable and easy to auto-complete.

• Functions that manipulate an object/data and return an object/data of the same type, should accept the object/data as the first argument of the function so as to enhance compatibility with the pipe operator (%>%)

Documentation

• All exported package functions should be fully documented with examples.

• When using roxygen2, add #' @noRd to internal functions.

Testing

• Changes should pass R CMD check/devtools::check() on all major platforms.

Conduct

We adhere to the R Consortium and the R Community Code of Conduct.

ellisvalentiner/lubridateExtras documentation built on March 31, 2022, 8:52 a.m.