Bioconductor's guide for package development, maintenance, and peer review. Read it here.
This book contains our guidelines for packages contributed to the Bioconductor suite of packages.
These guidelines are always a work in progress - corrections, suggestions and general improvements are welcome as issue submissions in this repository.
Open discussions are welcome in our Slack.
You can also suggest changes by editing the .Rmd files that are at the root of this repository and submitting a pull request.
An "Edit this page" link in the side bar on the right of each book chapter will take you directly to the relevant page on the GitHub repository to make such changes.
Please target your pull requests to the devel branch.
Deployment is done via GitHub Actions:
- whenever there's a push to
devel, the book is built and its content is then pushed to thegh-pagesbranch.
To preview the book locally - preferably before opening a pull request and while reviewing it - use the following code in an R console with the working directory set to the root of this repository, making sure that all the dependencies of the book are available (see file DESCRIPTION).
bookdown::render_book()This book is based on contents from the following original sources:
The template used for this book is credited to the book rOpenSci Packages: Development, Maintenance, and Peer Review:
- https://devguide.ropensci.org/ (deployed book)
- https://github.com/ropensci/dev_guide (source)