Merge pull request #657 from Crunch-io/default-new-ds-project-188559300

[188559300]: add fork examples

R/fork-and-merge.R

@@ -29,6 +29,16 @@ forks <- function(dataset) {
 #' folder as the existing dataset.
 #' @return The new fork, a `CrunchDataset`.
 #' @seealso [mergeFork()]
+#' @examples
+#' \dontrun{
+#' # Defaults to being placed in the same project folder as the original dataset
+#' ds_fork <- forkDataset(ds)
+#'
+#' # But you can specify a project by path, `ProjectFolder` object or URL
+#' ds_fork2 <- forkDataset(ds, project = "/Client1/forks/")
+#' ds_fork3 <- forkDataset(ds, project = projects()[["My forks"]])
+#' ds_fork4 <- forkDataset(ds, project = "https://app.crunch.io/api/projects/abc")
+#' }
 #' @export
 forkDataset <- function(dataset, name = defaultForkName(dataset), draft = FALSE, ..., project = folder(dataset)) {
     ## TODO: add owner field, default to self(me())