forkDataset {crunch}

Create a fork of a dataset

Description

Forking a dataset makes a copy of the data that is linked by Crunch's version control system to the original dataset. When you make edits to a fork, users of the original dataset do not see the changes.

Usage

forkDataset(dataset, name = defaultForkName(dataset), draft = FALSE, ...)

Arguments

dataset

The CrunchDataset to fork

name

character name to give the fork. If omitted, one will be provided for you

draft

logical: Should the dataset be a draft, visible only to those with edit permissions? Default is FALSE.

...

Additional dataset metadata to provide to the fork

Details

A common strategy for revising a dataset that has been shared with others is to fork it, make changes to the fork, and then merge those changes back into the original dataset. This workflow allows you to edit a dataset and review changes before publishing them, so that you don't accidentally send your clients incorrect data. For more on this workflow, see vignette("fork-and-merge", package = "crunch").

Value

The new fork, a CrunchDataset.

See Also

mergeFork()