Add contributors to README.Rmd

  repo = ".",
  ncols = 7,
  files = c("README.Rmd", ""),
  type = c("code", "issues", "discussion"),
  num_sections = 3,
  section_names = c("Code", "Issue Authors", "Issue Contributors"),
  format = "grid",
  alphabetical = FALSE,
  open_issue = FALSE,
  force_update = FALSE



Location of repository for which contributions are to be extracted. This must be a git project with a github remote.


Number of columns for contributors in 'README'


Names of files in which to add contributors


Type of contributions to include: 'code' for direct code contributions (including documentation), 'issues' to recognise contributors who open issues, and 'discussion' for contributing to discussions within issues. Discussion contributions are only from individuals not present in either 'issues' or 'code'; and 'issues' contributions are only from individuals not present in 'code'.


Number of sections in which to divide contributors:

  • 1 All contributions within single section regardless of type

  • 2 Contributions divided between a single section for code and a second section for all other issue-related contributions.

  • 3 Contributions divided into single sections for each of the three type arguments.


Names of the sections to appear on the nominated files.


One of ("grid", "list", "text") to control display of contributors as

  • 1 "grid" for a rectangular grid, with each contributor represented by their github avatar, with avatar linked to contributor profile and name linked to repository contributions.

  • 2 "list" for a more condensed list with github user names only and no avatars, one contributor per line linked to issue contributions.

  • 3 "text" for a single line of text containing comma-separated github user names linked to issue contributions.


If TRUE, order contributors alphabetically, otherwise order by decreasing numbers of contributions.


If TRUE, open or edit an issue on github in order to notify all contributors that they've been added to your README (see Note).


If TRUE, update the specified files even if contributions have not changed.


Named list of logical values indicating whether files of given names were updated or not is returned invisibly (that is, only if explicitly assigned to a return value).


Opening an issue on github requires the github command-line interface to be locally installed. See


# The following code extracts the contributors from the git repository # associated with current working directory and writes them to a file. if (FALSE) { f <- tempfile (fileext = ".Rmd") writeLines ("", f) # blank file in tempdir() add_contributors (repo = ".", files = f) }