add_description: Create a DESCRIPTION file

In rcompendium: Create a Package or Research Compendium Structure

Create a DESCRIPTION file

Description

This function creates a DESCRIPTION file at the root of the project. This file contains metadata of the project. Some information (title, description, version, etc.) must be edited by hand. For more information: https://r-pkgs.org/description.html. User credentials can be passed as arguments but it is recommended to store them in the .Rprofile file with set_credentials().

Usage

add_description(
  given = NULL,
  family = NULL,
  email = NULL,
  orcid = NULL,
  organisation = NULL,
  open = TRUE,
  overwrite = FALSE,
  quiet = FALSE
)

Arguments

given	A character of length 1. The given name of the project maintainer.
family	A character of length 1. The family name of the project maintainer.
email	A character of length 1. The email address of the project maintainer.
orcid	A character of length 1. The ORCID of the project maintainer.
organisation	A character of length 1. The name of the GitHub organisation to host the package. If NULL (default) the GitHub account will be used.
open	A logical value. If TRUE (default) the file is opened in the editor.
overwrite	A logical value. If a DESCRIPTION is already present and overwrite = TRUE, this file will be erased and replaced. Default is FALSE.
quiet	A logical value. If TRUE messages are deleted. Default is FALSE.

Value

No return value.

See Also

Other create files: add_citation(), add_code_of_conduct(), add_compendium(), add_contributing(), add_dockerfile(), add_license(), add_makefile(), add_package_doc(), add_readme_rmd(), add_renv(), add_testthat(), add_vignette()

Examples

## Not run: 
add_description(organisation = "MySociety")

## End(Not run)

rcompendium documentation built on Sept. 9, 2025, 5:29 p.m.