More documentation polishing

Author: hadley

R/release.R

@@ -4,10 +4,13 @@
 #' `r lifecycle::badge("deprecated")`
 #'
 #' `release()` is deprecated in favour of [usethis::use_release_issue()].
-#' We no longer feel confident recommrding `release()` because we don't use it
+#' We no longer feel confident recommending `release()` because we don't use it
 #' ourselves, so there's no guarantee that it will track best practices as
 #' they evolve over time.
 #'
+#' If you want to programmatical submit to CRAN, you can continue to use
+#' [submit_cran()].
+#'
 #' @template devtools
 #' @param check if `TRUE`, run checking, otherwise omit it.  This
 #'   is useful if you've just checked your package and you're ready to
@@ -228,23 +231,13 @@ cran_submission_url <- "https://xmpalantir.wu.ac.at/cransubmit/index2.php"
 #' Submit a package to CRAN
 #'
 #' @description
-
 #' This submits your package to CRAN using the web-form submission process.
-#' After submission, you will receive an email asking you to confirm submission
-#' - this is used to check that the package is submitted by the maintainer.
-#'
-#' You may prefer to use `submit_cran()` indirectly, by calling [release()]
-#' instead. `release()` performs many checks verifying that your package is
-#' indeed ready for CRAN, before eventually asking for your confirmation that
-#' you'd like to submit it to CRAN (which it does by calling `submit_cran()`).
+#' To complete the submission you will need respond to the email sent to the
+#' maintainer email address.
 #'
-#' Whether to use `release()` or `submit_cran()` depends on the rest of your
-#' development process. If you want to be super cautious, use `release()`, even
-#' though it may be redundant with other checks you have performed. On the other
-#' hand, if you have many other checks in place (such as automated checks via
-#' GitHub Actions and the task list generated by
-#' [usethis::use_release_issue()]), it makes sense to use `submit_cran()`
-#' directly.
+#' We generally recommend using this part of the process defined by
+#' [use_release_issue()]; this process maximizes the chances of a successful
+#' submission.
 #'
 #' @template devtools
 #' @inheritParams release