Merge branch 'main' into focardozom-add-create-quarto-project

Author: jennybc

R/create.R

@@ -11,7 +11,7 @@
 #'     more advanced usage.
 #'
 #' These functions work best when creating a project *de novo*, but
-#' `create_package()` and `create_project()` can be called in an existing
+#' `create_package()` and `create_project()` can be called on an existing
 #' project; you will be asked before any existing files are changed.
 #'
 #' @inheritParams use_description
@@ -31,11 +31,11 @@
 #'   `.here` file is placed to mark the project root.
 #' @param open If `TRUE`, [activates][proj_activate()] the new project:
 #'
-#'   * If using RStudio desktop, the project is opened in a new session.
-#'   * If using Positron, the project is opened in a new window.
-#'   * If on RStudio server, the current RStudio project is activated.
-#'   * Otherwise, the working directory and active project is changed in the
-#'     current R session.
+#'   * If using RStudio or Positron, the new project is opened in a new session,
+#'     window, or browser tab, depending on the product (RStudio or Positron)
+#'     and context (desktop or server).
+#'   * Otherwise, the working directory and active project of the current R
+#'     session are changed to the new project.
 #' @param type The type of Quarto project to create. See
 #'   `?quarto::quarto_create_project` for the most up-to-date list, but
 #'   `"website"`, `"blog"`, `"book"`, and `"manuscript"` are common choices.

R/proj.R

@@ -278,10 +278,17 @@ project_name <- function(base_path = proj_get()) {
 
 #' Activate a project
 #'
-#' Activates a project in usethis, R session, and (if relevant) RStudio senses.
-#' If you are in RStudio, this will open a new RStudio session. If not, it will
+#' Activates a project in the usethis, R session, and (if relevant) RStudio
+#' senses. If you are in RStudio, this will open a new RStudio session. If not, it will
 #' change the working directory and [active project][proj_set()].
 #'
+#' * If using RStudio desktop, the project is opened in a new session.
+#'   * If using Positron, the project is opened in a new window.
+#'   * If using RStudio or Positron on a server, the project is opened in a new
+#'     browser tab.
+#'   * Otherwise, the working directory and active project is changed in the
+#'     current R session.
+#'
 #' @param path Project directory
 #' @return Single logical value indicating if current session is modified.
 #' @export