Act on feedback from @maelle

Author: jennybc

R/package.R

@@ -1,9 +1,9 @@
 #' Depend on another package
 #'
 #' `use_package()` adds a CRAN package dependency to DESCRIPTION and offers a
-#' little advice about how to best use it. `use_dev_package()` adds a dependency
-#' on an in-development GitHub package, adding the repo to `Remotes` so it will
-#' be automatically installed from the correct location.
+#' little advice about how to best use it. `use_dev_package()` adds a versioned
+#' dependency on an in-development GitHub package, adding the repo to `Remotes`
+#' so it will be automatically installed from the correct location.
 #'
 #' @param package Name of package to depend on.
 #' @param type Type of dependency: must be one of "Imports", "Depends",
@@ -17,6 +17,7 @@
 #' \dontrun{
 #' use_package("ggplot2")
 #' use_package("dplyr", "suggests")
+#' use_dev_package("glue")
 #' }
 use_package <- function(package, type = "Imports") {
   types <- tolower(c("Imports", "Depends", "Suggests", "Enhances", "LinkingTo"))

R/pkgdown.R

@@ -2,7 +2,7 @@
 #'
 #' [pkgdown](https://github.com/hadley/pkgdown) makes it easy to turn your
 #' package into a beautiful website. This helper creates `_pkgdown.yml`
-#' and `docs/` for you, and adds to `.Rbuildignore`
+#' and `docs/` for you, and adds them to `.Rbuildignore`
 #'
 #' @export
 use_pkgdown <- function() {

R/r.R

@@ -1,4 +1,4 @@
-#' Create a new R file
+#' Create or edit a .R file
 #'
 #' @param name File name, without extension; will create if it doesn't already
 #'   exist. If not specified, and you're currently in a test file, will guess

R/tidyverse.R

@@ -1,4 +1,4 @@
-#' Helpers for the tidyverse
+#' Helpers for tidyverse development
 #'
 #' These helpers follow tidyverse conventions which are generally a little
 #' stricter than the defaults, reflecting the need for greater rigor in