We welcome contributions to RMAVIS
or suggestions for improvement. However,
we first ask that you email Zeke Marshall
to discuss the the scope of the contribution to ensure that any contributions
are aligned with the development strategy for RMAVIS
.
If you would like to collaborate on the development of RMAVIS
please take the following steps:
- Fork the repository and create a new branch.
- Run
renv::restore()
to install the current dependencies ofRMAVIS
, along with development helper packages such as{usethis}
. - Develop the code you wish to contribute.
- Add tests for any new functions placed in the ./R folder.
- Add provisional release notes in the NEWS.md file throughout development.
- Update the DESCRIPTION file to include the following provisional information:
- An updated version number.
- Any changes to the dependencies.
- Your author details.
- Add your author details to CITATION.cff.
- Update the version number in the app Documentation.Rmd file, Report.Rmd file, README.Rmd file and re-render the documentation and README.
- Update the renv.lock file to capture the dependencies used to make your contribution using
renv::snapshot()
. - Document any additional bundled data in ./R/data.R
- Re-render the package documentation.
- Check the package builds.
- Check the package installs.
- Ensure that the package checks pass (at present there are some notes and warnings that I need to clear up).
- Source the ./data-raw/prepare_appfiles.R to ensure that the README.md and NEWS.md are copied to the app directory.
- Tag @ZekeMarshall in any issues, or when you wish to make a pull request.
To report bugs, suggest enhancements, request advice on usage, or ask a question please raise an issue here.
By contributing, you agree that your contributions will be licensed under the GNU Lesser General Public License.