Fix typos + add cross-references

R/build-articles.R

@@ -174,8 +174,7 @@
 #'
 #' # Suppressing vignettes
 #' If you want [articles](https://r-pkgs.org/vignettes.html#sec-vignettes-article)
-#'  that are not vignettes, use `usethis::use_article()` either put them in
-#' subdirectories or list in `.Rbuildignore`. An articles link will be
+#' that are not vignettes, use `usethis::use_article()` to create it. An articles link will be
 #' automatically added to the default navbar if the vignettes directory is
 #' present: if you do not want this, you will need to customise the navbar. See
 #' [build_site()] details.

R/build-favicons.R

@@ -1,16 +1,16 @@
-#' Create favicons from package logo
+#' Initialise favicons from package logo
 #'
 #' This function auto-detects the location of your package logo (with the name
-#' `logo.svg` (recommended format) or `logo.png`) and runs it through the
-#' <https://realfavicongenerator.net> API to build a complete set of favicons
-#' with different sizes, as needed for modern web usage.
+#' `logo.svg` (recommended format) or `logo.png`, created with `usethis::use_logo()`)
+#' and runs it through the <https://realfavicongenerator.net> API to build a
+#' complete set of favicons with different sizes, as needed for modern web usage.
 #'
 #' You only need to run the function once. The favicon set will be stored in
 #' `pkgdown/favicon` and copied by [init_site()] to the relevant location when
 #' the website is rebuilt.
 #'
 #' Once complete, you should add `pkgdown/` to `.Rbuildignore ` to avoid a NOTE
-#' during package checking.
+#' during package checking. (`usethis::use_logo()` does this for you!)
 #'
 #' @inheritParams as_pkgdown
 #' @param overwrite If `TRUE`, re-create favicons from package logo.

R/build-reference.R

@@ -83,7 +83,7 @@
 #' * `has_lifecycle("deprecated")` will select all topics with lifecycle 
 #'   deprecated.
 #'
-#' All functions (except for `has_keywords()`) automatically exclude internal
+#' All functions (except for `has_keyword()`) automatically exclude internal
 #' topics (i.e. those with `\keyword{internal}`). You can choose to include
 #' with (e.g.) `starts_with("build_", internal = TRUE)`.
 #'

pkgdown/_pkgdown.yml

@@ -63,10 +63,9 @@ reference:
   desc: These functions are useful for rapid iteration when you're working on a
     specific part of your site.
   contents:
-  - starts_with("build_")
-  - -build_site
-  - -build_site_github_pages
-  - -build_favicons
+  - has_concept("site components")
+  - build_search
+  - build_redirects
   - init_site
 
 - subtitle: Customisation
@@ -98,6 +97,7 @@ reference:
 
 redirects:
 - ["articles/search.html", "reference/build_search.html"]
+- ["articles/pkgdown.html#language", "articles/translations.html"]
 
 news:
   releases:

vignettes/translations.Rmd

@@ -92,5 +92,5 @@ Then commit your changes to Git and submit your pull request for review:
 
 ```{r}
 #| eval: false
-usethis::pr_submit()
+usethis::pr_push()
 ```