use_bioc_readme_rmd: Create a biocthis-style README.Rmd file

View source: R/use_bioc_readme_rmd.R

use_bioc_readme_rmdR Documentation

Create a biocthis-style README.Rmd file

Description

This function is very similar to usethis::use_readme_rmd() except that it uses a template from biocthis. This template README.Rmd includes information on how to install your Bioconductor package, how to cite it, and thanks the authors of several packages. It was built on top of the original template from usethis::use_readme_rmd().

Usage

use_bioc_readme_rmd(open = rlang::is_interactive())

Arguments

open

Open the newly created file for editing? Happens in RStudio, if applicable, or via utils::file.edit() otherwise. This argument has the same behavior as the open argument used in usethis functions.

Value

This function adds and/or replaces the README.Rmd file in your R package. It's useful to use devtools::build_readme() after running this function or whenever you update the README.Rmd file.

Examples

## Not run: 
## Run this function in your package
use_bioc_readme_rmd()

## End(Not run)

## Create an example package for illustrative purposes.
## Note: you do not need to run this for your own package!
pkgdir <- biocthis_example_pkg(use_git = TRUE)

## Create a template README.Rmd file that is Bioconductor-friendly
biocthis::use_bioc_readme_rmd()

lcolladotor/biocthis documentation built on Dec. 12, 2024, 10:01 p.m.