diff --git a/DESCRIPTION b/DESCRIPTION
index 7222eeaaa..3bbef16bd 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -34,7 +34,7 @@ Imports:
     purrr (>= 1.0.0),
     ragg,
     rlang (>= 1.1.0),
-    rmarkdown (>= 1.1.9007),
+    rmarkdown (>= 2.26.2),
     tibble,
     whisker,
     withr (>= 2.4.3),
@@ -45,10 +45,12 @@ Suggests:
     diffviewer,
     evaluate,
     gert,
+    gt,
     htmltools,
     htmlwidgets,
     knitr,
     lifecycle,
+    magick,
     methods,
     openssl,
     pkgload (>= 1.0.2),
@@ -70,3 +72,5 @@ Encoding: UTF-8
 Roxygen: list(markdown = TRUE)
 RoxygenNote: 7.3.1
 SystemRequirements: pandoc
+Remotes:  
+    rstudio/rmarkdown
diff --git a/NAMESPACE b/NAMESPACE
index 7ae939ddb..697768d9e 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -89,6 +89,7 @@ S3method(as_html,tag_url)
 S3method(as_html,tag_var)
 S3method(as_html,tag_verb)
 S3method(pkgdown_print,default)
+S3method(pkgdown_print,gt_tbl)
 S3method(pkgdown_print,htmlwidget)
 S3method(print,pkgdown_xml)
 S3method(print,print_yaml)
@@ -116,6 +117,7 @@ export(build_favicons)
 export(build_home)
 export(build_home_index)
 export(build_news)
+export(build_redirects)
 export(build_reference)
 export(build_reference_index)
 export(build_search)
diff --git a/NEWS.md b/NEWS.md
index 002aa7a7e..6e4f6c868 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,6 +1,19 @@
 # pkgdown (development version)
 
 * The title for the "Reference" page is now "Package index" since this page might contain more than just function details (#2181).
+* `build_redirects()` now automatically adds redirects for topic 
+aliases. This matches the behaviour of `?` and will help keep links stable in the long term (#1876).
+* `build_redirects()` now reports which redirects it is generating.
+* The addin now runs `build_site()` instead of `build_site_external()`, which generally should be more reliable (#2252).
+* Anchors are displayed when they're the target of a link.
+* `build_reference()` adds anchors to arguments making it possible to link directly to an argument, if desired. A subtle visual treatment makes it easy to see which argument is targeted (#2228).
+* `build_redirects()` is now exported to make it easier to document (#2500).
+* `build_reference()` now automatically renders any tables created by gt (#2326).
+* `build_articles()` now drops a section called "internal". This allows you to have articles that either aren't indexed at all or are included manually elsewhere in the navbar (#2205).
+* `as.pkgdown()` will no longer prompt you to install a missing template package from CRAN, since these are almost always found in GitHub (#2076).
+* `init_site()` once again describes one copy per line, and now uses a better prefix when copying assets from pkgdown itself (#2445).
+* Very wide words are now automatically broken across lines and hyphenated (when possible) when they'd otherwise create a horizontal scrollbar on mobile (#1888).
+* The `repo.source.url` field no longer requires a trailing slash (#2017).
 * Anywhere you can use `_pkgdown.yml`, you can now use `_pkgdown.yaml` (#2244).
 * pkgdown no longer overrides the default selection colours. This improves accessibility for users who have set their own colours in their browser settings (#2139, @glin).
 * `build_article()` now escapes html characters in the title (#2286).
diff --git a/R/build-articles.R b/R/build-articles.R
index ddeb27406..0582f769a 100644
--- a/R/build-articles.R
+++ b/R/build-articles.R
@@ -19,7 +19,7 @@
 #' package, not the current source version. This makes iteration quicker when
 #' you are primarily working on the text of an article.
 #'
-#' @section Index and navbar:
+#' # Index and navbar
 #' You can control the articles index and navbar with a `articles` field in
 #' your `_pkgdown.yml`. If you use it, pkgdown will check that all articles
 #' are included, and will error if you have missed any.
@@ -77,7 +77,7 @@
 #' the navbar, it will link directly to the articles index instead of
 #' providing a drop-down.
 #'
-#' @section Get started:
+#' # Get started
 #' Note that a vignette with the same name as the package (e.g.,
 #' `vignettes/pkgdown.Rmd` or `vignettes/articles/pkgdown.Rmd`) automatically
 #' becomes a top-level "Get started" link, and will not appear in the articles
@@ -86,7 +86,14 @@
 #' (If your package name includes a `.`, e.g. `pack.down`, use a `-` in the
 #' vignette name, e.g. `pack-down.Rmd`.)
 #'
-#' @section External files:
+#' ## Missing topics
+#'
+#' pkgdown will warn if there are (non-internal) articles that aren't listed 
+#' in the articles index. You can suppress such warnings by listing the 
+#' affected articles in a section with `title: internal` (case sensitive); 
+#' this section will not be displayed on the index page.
+#'
+#' # External files
 #' pkgdown differs from base R in its handling of external files. When building
 #' vignettes, R assumes that vignettes are self-contained (a reasonable
 #' assumption when most vignettes were PDFs) and only copies files explicitly
@@ -107,7 +114,7 @@
 #' Note that you can not use the `fig.path` to change the output directory of
 #' generated figures as its default value is a strong assumption of rmarkdown.
 #'
-#' @section Embedding Shiny apps:
+#' # Embedding Shiny apps
 #' If you would like to embed a Shiny app into an article, the app will have
 #' to be hosted independently, (e.g. <https://www.shinyapps.io>). Then, you
 #' can embed the app into your article using an `<iframe>`, e.g.
@@ -116,7 +123,7 @@
 #' See <https://github.com/r-lib/pkgdown/issues/838#issuecomment-430473856> for
 #' some hints on how to customise the appearance with CSS.
 #'
-#' @section Output formats:
+#' # Output formats
 #' By default, pkgdown builds all articles using the
 #' [rmarkdown::html_document()] `output` format, ignoring whatever is set in
 #' your YAML metadata. This is necessary because pkgdown has to integrate the
@@ -148,15 +155,15 @@
 #'
 #' Additionally, htmlwidgets do not work when `as_is: true`.
 #'
-#' @inheritSection build_reference Figures
-#'
-#' @section Suppressing vignettes:
+#' # Suppressing vignettes
 #' If you want articles that are not vignettes, either put them in
 #' subdirectories or list in `.Rbuildignore`. 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.
 #'
+#' @inheritSection build_reference Figures
+#'
 #' @inheritParams as_pkgdown
 #' @param quiet Set to `FALSE` to display output of knitr and
 #'   pandoc. This is useful when debugging.
@@ -395,6 +402,9 @@ data_articles_index <- function(pkg = ".") {
     )
   }
 
+  # Remove internal section after missing vignettes check
+  sections <- Filter(function(x) x$title != "internal", sections)
+
   print_yaml(list(
     pagetitle = tr_("Articles"),
     sections = sections
diff --git a/R/build-favicons.R b/R/build-favicons.R
index 27c425d2a..76ae0623f 100644
--- a/R/build-favicons.R
+++ b/R/build-favicons.R
@@ -109,11 +109,12 @@ build_favicons <- function(pkg = ".", overwrite = FALSE) {
 copy_favicons <- function(pkg = ".") {
   pkg <- as_pkgdown(pkg)
 
-  favicons <- path(pkg$src_path, "pkgdown", "favicon")
-  if (!dir_exists(favicons))
-    return()
-
-  dir_copy_to(pkg, favicons, pkg$dst_path)
+  dir_copy_to(
+    src_dir = path(pkg$src_path, "pkgdown", "favicon"),
+    src_root = pkg$src_path,
+    dst_dir = pkg$dst_path,
+    dst_root = pkg$dst_path
+  )
 }
 
 has_favicons <- function(pkg = ".") {
diff --git a/R/build-home.R b/R/build-home.R
index ad10e8b72..8c085e59c 100644
--- a/R/build-home.R
+++ b/R/build-home.R
@@ -68,12 +68,7 @@
 #' 
 #' [init_site()] will also automatically create a favicon set from your package logo.
 #' 
-#' ## YAML config - home
-#' 
-#' To tweak the home page, you need a section of the configuration file called 
-#' `home`.
-#' 
-#' ### Page title and description
+#' ## YAML config - title and description
 #' 
 #' By default, the page title and description are extracted automatically from
 #' the `Title` and `Description` fields `DESCRIPTION` (stripping single quotes
@@ -91,7 +86,8 @@
 #'     to your growing collection.
 #' ```
 #' 
-#' (Note the use of YAML's `>` i.e. "YAML pipes"; this is a convenient way of writing paragraphs of text.)
+#' (Note the use of YAML's `>` i.e. "YAML pipes"; this is a convenient way of 
+#' writing paragraphs of text.)
 #' 
 #' ## Dev badges
 #' 
@@ -154,9 +150,10 @@
 #'   )
 #' ```
 #' 
-#' ## YAML config - authors
+#' ## Additional control via YAML
 #' 
-#' You can tweak a few things via the `authors` YAML field:
+#' You can control additinal aspects of the authors display via the `authors` 
+#' YAML field:
 #' 
 #' * display of each author in the footer, sidebar and authors page,
 #' * which authors (by role) are displayed in the sidebar and footer,
@@ -164,7 +161,6 @@
 #' * text before and after authors in the sidebar,
 #' * text before and after authors on the authors page.
 #' 
-#' 
 #' You can modify how each author's name is displayed by adding a subsection 
 #' for `authors`. Each entry in `authors` should be named the author's name 
 #' (matching `DESCRIPTION`) and can contain `href` and/or `html` fields:
diff --git a/R/build-logo.R b/R/build-logo.R
index 94241a44b..80b8d4d73 100644
--- a/R/build-logo.R
+++ b/R/build-logo.R
@@ -3,7 +3,12 @@ copy_logo <- function(pkg = ".") {
 
   logo_path <- find_logo(pkg$src_path)
   if (!is.null(logo_path)) {
-    file_copy_to(pkg, logo_path, from_dir = path_dir(logo_path))
+    file_copy_to(
+      src_paths = logo_path,
+      src_root = pkg$src_path,
+      dst_paths = path(pkg$dst_path, path_file(logo_path)),
+      dst_root = pkg$dst_path
+    )
   }
 }
 
diff --git a/R/build-news.R b/R/build-news.R
index 23dbb0d73..54703c330 100644
--- a/R/build-news.R
+++ b/R/build-news.R
@@ -38,7 +38,7 @@
 #' be added to the heading (see below for how to suppress); if not
 #' available on CRAN, "Unreleased" will be added.
 #'
-#' @section YAML config:
+#' # YAML config
 #'
 #' To automatically link to release announcements, include a `releases`
 #' section.
diff --git a/R/build-redirects.R b/R/build-redirects.R
index 9bd64871f..fb23c9ff8 100644
--- a/R/build-redirects.R
+++ b/R/build-redirects.R
@@ -1,12 +1,42 @@
+#' Build redirects
+#' 
+#' @description
+#' If you change the structure of your documentation (by renaming vignettes or 
+#' help topics) you can setup redirects from the old content to the new content.
+#' One or several now-absent pages can be redirected to a new page (or to a new 
+#' section of a new page). This works by creating a html page that performs a 
+#' "meta refresh", which isn't the best way of doing a redirect but works 
+#' everywhere that you might deploy your site.
+#' 
+#' The syntax is the following, with old paths on the left, and new paths or 
+#' URLs on the right.
+#' 
+#' ```yaml
+#' redirects:
+#'   - ["articles/old-vignette-name.html", "articles/new-vignette-name.html"]
+#'   - ["articles/another-old-vignette-name.html", "articles/new-vignette-name.html"]
+#'   - ["articles/yet-another-old-vignette-name.html", "https://pkgdown.r-lib.org/dev"]
+#' ```
+#' 
+#' If for some reason you choose to redirect an existing page make sure to 
+#' exclude it from the search index, see `?build_search`.
+#'
+#' @inheritParams as_pkgdown
+#' @export
 build_redirects <- function(pkg = ".",
                             override = list()) {
   pkg <- section_init(pkg, depth = 1L, override = override)
 
   redirects <- c(
+    reference_redirects(pkg),
     article_redirects(pkg),
     pkg$meta$redirects
   )
 
+  # Ensure user redirects override automatic ones
+  from <- purrr::map_chr(redirects, 1)
+  redirects <- redirects[!duplicated(from)]
+
   if (is.null(redirects)) {
     return(invisible())
   }
@@ -48,6 +78,10 @@ build_redirect <- function(entry, index, pkg) {
   url <- sprintf("%s/%s%s", pkg$meta$url, pkg$prefix, new)
   lines <- whisker::whisker.render(template, list(url = url))
   dir_create(path_dir(old))
+
+  if (!file_exists(old)) {
+    cli::cli_inform("Adding redirect from {entry[1]} to {entry[2]}.")
+  }
   write_lines(lines, old)
 }
 
@@ -64,3 +98,25 @@ article_redirects <- function(pkg) {
   articles <- pkg$vignettes$file_out[is_vig_in_articles]
   purrr::map(articles, ~ paste0(c("articles/", ""), .x))
 }
+
+reference_redirects <- function(pkg) {
+  if (is.null(pkg$meta$url)) {
+    return(NULL)
+  }
+
+  aliases <- unname(pkg$topics$alias)
+  aliases <- purrr::map2(aliases, pkg$topics$name, setdiff)
+  names(aliases) <- pkg$topics$file_out
+
+  redirects <- invert_index(aliases)
+  if (length(redirects) == 0) {
+    return(list())
+  }
+
+  names(redirects) <- paste0(names(redirects), ".html")
+
+  # Ensure we don't override an existing file
+  redirects <- redirects[setdiff(names(redirects), pkg$topics$file_out)]
+
+  unname(purrr::imap(redirects, function(to, from) paste0("reference/", c(from, to))))
+}
diff --git a/R/build-reference.R b/R/build-reference.R
index 9e0f4e24b..7029f2563 100644
--- a/R/build-reference.R
+++ b/R/build-reference.R
@@ -4,7 +4,7 @@
 #' alphabetical order. To override this, provide a `reference` section in your
 #' `_pkgdown.yml` as described below.
 #'
-#' @section Reference index:
+#' # Reference index
 #' To tweak the index page, add a section called `reference` to `_pkgdown.yml`.
 #' It can contain three different types of element:
 #'
@@ -104,12 +104,12 @@
 #' either 30x30 (for regular display) or 60x60 (if you want retina display).
 #' Icons are matched to topics by aliases.
 #'
-#' ## Examples
+#' # Examples
 #'
 #' If you need to run extra code before or after all examples are run, you
 #' can create `pkgdown/pre-reference.R` and `pkgdown/post-reference.R`.
 #'
-#' @section Figures:
+#' # Figures
 #'
 #' You can control the default rendering of figures by specifying the `figures`
 #' field in `_pkgdown.yml`. The default settings are equivalent to:
@@ -207,11 +207,12 @@ build_reference <- function(pkg = ".",
 
 copy_figures <- function(pkg) {
   # copy everything from man/figures to docs/reference/figures
-  src_figures <- path(pkg$src_path, "man", "figures")
-  dst_figures <- path(pkg$dst_path, "reference", "figures")
-  if (file_exists(src_figures)) {
-    dir_copy_to(pkg, src_figures, dst_figures)
-  }
+  dir_copy_to(
+    src_dir = path(pkg$src_path, "man", "figures"),
+    src_root = pkg$src_path,
+    dst_dir = path(pkg$dst_path, "reference", "figures"),
+    dst_root = pkg$dst_path
+  )
 }
 
 examples_env <- function(pkg, seed = 1014L, devel = TRUE, envir = parent.frame()) {
@@ -254,11 +255,12 @@ build_reference_index <- function(pkg = ".") {
   create_subdir(pkg, "reference")
 
   # Copy icons, if needed
-  src_icons <- path(pkg$src_path, "icons")
-  dst_icons <- path(pkg$dst_path, "reference", "icons")
-  if (file_exists(src_icons)) {
-    dir_copy_to(pkg, src_icons, dst_icons)
-  }
+  dir_copy_to(
+    src_dir = path(pkg$src_path, "icons"),
+    src_root = pkg$src_path,
+    dst_dir = path(pkg$dst_path, "reference", "icons"),
+    dst_root = pkg$dst_path
+  )
 
   render_page(
     pkg, "reference-index",
diff --git a/R/build-search-docs.R b/R/build-search-docs.R
index 012b93986..782ce9bd4 100644
--- a/R/build-search-docs.R
+++ b/R/build-search-docs.R
@@ -29,6 +29,7 @@ build_sitemap <- function(pkg = ".") {
     return()
   }
 
+  cli::cli_rule("Building sitemap")
   if (pkg$development$in_dev && pkg$bs_version > 3) {
     url <- paste0(url, pkg$prefix)
   }
@@ -38,8 +39,8 @@ build_sitemap <- function(pkg = ".") {
   doc <- xml2::read_xml(
     paste0("<urlset xmlns = 'http://www.sitemaps.org/schemas/sitemap/0.9'></urlset>")
   )
-
-  url_nodes <- purrr::map(urls, url_node)
+  
+  url_nodes <- unwrap_purrr_error(purrr::map(urls, url_node))
   for (url in url_nodes) {
     xml2::xml_add_child(doc, url)
   }
@@ -53,8 +54,13 @@ build_sitemap <- function(pkg = ".") {
 }
 
 url_node <- function(url) {
-  xml2::read_xml(
-    paste0("<url><loc>", url, "</loc></url>")
+  withCallingHandlers(
+    xml2::read_xml(
+      paste0("<url><loc>", url, "</loc></url>")
+    ),
+    error = function(err) {
+      cli::cli_abort("Failed to wrap URL {.str {url}}", parent = err)
+    }
   )
 }
 
@@ -62,7 +68,7 @@ url_node <- function(url) {
 #'
 #' Build a JSON file encompassing all HTML pages, for use by the search script.
 #'
-#' @section YAML config:
+#' # YAML config
 #' You can exclude some paths from the search index.
 #' Below we exclude the changelog from the search index.
 #'
@@ -70,7 +76,7 @@ url_node <- function(url) {
 #' search:
 #'   exclude: ['news/index.html']
 #' ```
-#' @section Debugging and local testing:
+#' # Debugging and local testing
 #'
 #' Locally (as opposed to on GitHub Pages or Netlify for instance),
 #' search won't work if you simply use pkgdown preview of the static files.
diff --git a/R/build-tutorials.R b/R/build-tutorials.R
index e75728fa7..b92357c51 100644
--- a/R/build-tutorials.R
+++ b/R/build-tutorials.R
@@ -7,7 +7,7 @@
 #' `inst/tutorials` and `vignettes/tutorials`. Alternatively, you can
 #' list in `_pkgdown.yml` as described below.
 #'
-#' @section YAML config:
+#' # YAML config
 #' To override the default discovery process, you can provide a `tutorials`
 #' section. This should be a list where each element specifies:
 #'
diff --git a/R/build.R b/R/build.R
index 470abe7ed..0f1640dec 100644
--- a/R/build.R
+++ b/R/build.R
@@ -9,6 +9,7 @@
 #' * [build_articles()]
 #' * [build_tutorials()]
 #' * [build_news()]
+#' * [build_redirects()]
 #'
 #' See the documentation for the each function to learn how to control
 #' that aspect of the site. This page documents options that affect the
@@ -44,7 +45,7 @@
 #' The `search` field controls the built-in search and is
 #' documented in `vignette("search")`.
 #'
-#' @section Development mode:
+#' # Development mode
 #' The `development` field allows you to generate different sites for the
 #' development and released versions of your package. To use it, you first
 #' need to set the development `mode`:
@@ -56,21 +57,22 @@
 #'
 #' ### Setting development mode
 #'
-#' The development `mode` of a site controls where the site is built,
-#' the colour of the package version in the navbar, the version tooltip,
-#' and whether or not the site is indexed by search engines. There are
-#' four possible modes:
+#' The development `mode` of a site controls where the built site is placed
+#' and how it is styled (i.e. the colour of the package version in the 
+#' navbar, the version tooltip), and whether or not the site is indexed by 
+#' search engines. There are four possible modes:
 #'
-#' * **automatic** (`mode: auto`): automatically determines the mode based on the
-#'   version number:
+#' * **automatic** (`mode: auto`): determines the mode based on the version:
 #'
 #'   * `0.0.0.9000` (`0.0.0.*`): unreleased.
 #'   * four version components: development.
 #'   * everything else -> release.
 #'
-#' * **release** (`mode: release`), the default. Site is written to `docs/`.
-#'   Version in navbar gets the default colouring. Development badges are
-#'   not shown in the sidebar (see `?build_home`).
+#' * **release** (`mode: release`), the default. Site is written to `docs/`
+#'   and styled like a released package, even if the content is for an 
+#'   unreleased or development version. Version in navbar gets the default 
+#'   colouring. Development badges are not shown in the sidebar 
+#'   (see `?build_home`).
 #'
 #' * **development** (`mode: devel`). Site is written to `docs/dev/`.
 #'   The navbar version gets a "danger" class and a tooltip stating these are
@@ -83,6 +85,10 @@
 #'   package is not yet on CRAN.
 #'   Development badges are shown in the sidebar (see `?build_home`).
 #'
+#' Use `mode: auto` if you want both a released and a dev site, and 
+#' `mode: release` if you just want a single site. It is very rare that you 
+#' will need either devel or unreleased modes.
+#'
 #' You can override the mode specified in the `_pkgdown.yml` by setting
 #' by setting `PKGDOWN_DEV_MODE` to `devel` or `release`.
 #'
@@ -133,11 +139,13 @@
 #' to danger). Finally, you can choose to override the default tooltip with
 #' `version_tooltip`.
 #'
-#' @section Template:
+#' # Template
 #' The `template` field is mostly used to control the appearance of the site.
-#' See `vignette("customise")` for details.
+#' See `vignette("customise")` for details. But it's also used to control
+#'
+#' ## Other aspects
 #'
-#' There are two other `template` fields that control other aspects of the
+#' There are a few other `template` fields that control other aspects of the
 #' site:
 #'
 #' *   `noindex: true` will suppress indexing of your pages by search engines:
@@ -166,7 +174,7 @@
 #'        trailing_slash_redirect: true
 #'      ```
 #'
-#' @section Analytics:
+#' ## Analytics
 #'
 #' To capture usage of your site with a web analytics tool, you can make
 #' use of the `includes` field to add the special HTML they need. This HTML
@@ -212,8 +220,8 @@
 #'           <script data-goatcounter="https://{YOUR CODE}.goatcounter.com/count" data-goatcounter-settings="{YOUR SETTINGS}" async src="https://gc.zgo.at/count.js"></script>
 #'     ```
 #'
+#' # Source repository
 #'
-#' @section Source repository:
 #' Use the `repo` field to override pkgdown's automatically discovery
 #' of your source repository. This is used in the navbar, on the homepage,
 #' in articles and reference topics, and in the changelog (to link to issue
@@ -260,7 +268,7 @@
 #'   branch: devel
 #' ```
 #'
-#' @section Deployment (`deploy`):
+#' # Deployment (`deploy`)
 #' There is a single `deploy` field
 #'
 #' *  `install_metadata` allows you to install package index metadata into
@@ -274,28 +282,7 @@
 #'      install_metadata: true
 #'    ```
 #'
-#' @section Redirects:
-#' If you change the structure of your documentation (by renaming vignettes or 
-#' help topics) you can setup redirects from the old content to the new content.
-#' One or several now-absent pages can be redirected to a new page (or to a new 
-#' section of a new page). This works by creating a html page that performs a 
-#' "meta refresh", which isn't the best way of doing a redirect but works 
-#' everywhere that you might deploy your site.
-#' 
-#' The syntax is the following, with old paths on the left, and new paths or 
-#' URLs on the right.
-#' 
-#' ```yaml
-#' redirects:
-#'   - ["articles/old-vignette-name.html", "articles/new-vignette-name.html"]
-#'   - ["articles/another-old-vignette-name.html", "articles/new-vignette-name.html"]
-#'   - ["articles/yet-another-old-vignette-name.html", "https://pkgdown.r-lib.org/dev"]
-#' ```
-#' 
-#' If for some reason you choose to redirect an existing page make sure to 
-#' exclude it from the search index, see `?build_search`.
-#'
-#' @section Options:
+#' # Options
 #' Users with limited internet connectivity can disable CRAN checks by setting
 #' `options(pkgdown.internet = FALSE)`. This will also disable some features
 #' from pkgdown that requires an internet connectivity. However, if it is used
diff --git a/R/context.R b/R/context.R
index 24234b744..1372659a8 100644
--- a/R/context.R
+++ b/R/context.R
@@ -69,6 +69,6 @@ context_set_scoped <- function(name, value, scope = parent.frame()) {
 article_index <- function(pkg) {
   set_names(
     fs::path_rel(pkg$vignettes$file_out, "articles"),
-    path_file(pkg$vignettes$name)
+    pkg$vignettes$name
   )
 }
diff --git a/R/init.R b/R/init.R
index a594c118d..d205572fa 100644
--- a/R/init.R
+++ b/R/init.R
@@ -11,7 +11,7 @@
 #' See `vignette("customise")` for the various ways you can customise the
 #' display of your site.
 #'
-#' @section Build-ignored files:
+#' # Build-ignored files
 #' We recommend using [usethis::use_pkgdown()] to build-ignore `docs/` and
 #' `_pkgdown.yml`. If use another directory, or create the site manually,
 #' you'll need to add them to `.Rbuildignore` yourself. A `NOTE` about
@@ -58,23 +58,22 @@ copy_assets <- function(pkg = ".") {
 
   # pkgdown assets
   if (!identical(template$default_assets, FALSE)) {
-    copy_asset_dir(pkg, path_pkgdown(paste0("BS", pkg$bs_version), "assets"))
-  }
-
-  # manually specified directory: I don't think this is documented
-  # and no longer seems important, so I suspect it could be removed
-  if (!is.null(template$assets)) {
-    copy_asset_dir(pkg, template$assets)
+    copy_asset_dir(
+      pkg, 
+      path_pkgdown(paste0("BS", pkg$bs_version, "/", "assets")), 
+      src_root = path_pkgdown(),
+      src_label = "<pkgdown>/"
+    )
   }
 
   # package assets
   if (!is.null(template$package)) {
-    assets <- path_package_pkgdown(
-      "assets",
-      package = template$package,
-      bs_version = pkg$bs_version
+    copy_asset_dir(
+      pkg, 
+      path_package_pkgdown("assets", template$package, pkg$bs_version),
+      src_root = system_file(package = template$package),
+      src_label = paste0("<", template$package, ">/")
     )
-    copy_asset_dir(pkg, assets)
   }
 
   # extras
@@ -85,27 +84,32 @@ copy_assets <- function(pkg = ".") {
   invisible()
 }
 
-copy_asset_dir <- function(pkg, from_dir, file_regexp = NULL) {
-  if (length(from_dir) == 0) {
-    return(character())
-  }
-  from_path <- path_abs(from_dir, pkg$src_path)
-  if (!file_exists(from_path)) {
+copy_asset_dir <- function(pkg,
+                           dir,
+                           src_root = pkg$src_path,
+                           src_label = "",
+                           file_regexp = NULL) {
+  src_dir <- path_abs(dir, pkg$src_path)
+  if (!file_exists(src_dir)) {
     return(character())
   }
 
-  files <- dir_ls(from_path, recurse = TRUE)
-
-  # Remove directories from files
-  files <- files[!fs::is_dir(files)]
-
+  src_paths <- dir_ls(src_dir, recurse = TRUE)
+  src_paths <- src_paths[!fs::is_dir(src_paths)]
   if (!is.null(file_regexp)) {
-    files <- files[grepl(file_regexp, path_file(files))]
+    src_paths <- src_paths[grepl(file_regexp, path_file(src_paths))]
   }
-  # Handled in bs_theme()
-  files <- files[path_ext(files) != "scss"]
+  src_paths <- src_paths[path_ext(src_paths) != "scss"] # Handled in bs_theme()
 
-  file_copy_to(pkg, files, pkg$dst_path, from_dir = from_path)
+  dst_paths <- path(pkg$dst_path, path_rel(src_paths, src_dir))
+
+  file_copy_to(
+    src_paths = src_paths,
+    src_root = src_root,
+    src_label = src_label,
+    dst_paths = dst_paths,
+    dst_root = pkg$dst_path
+  )
 }
 
 timestamp <- function(time = Sys.time()) {
diff --git a/R/package.R b/R/package.R
index ed950b96e..a0e605928 100644
--- a/R/package.R
+++ b/R/package.R
@@ -228,9 +228,7 @@ package_topics <- function(path = ".", package = "pkgdown") {
   source <- purrr::map(rd, extract_source)
 
   file_in <- names(rd)
-
-  file_out <- gsub("\\.Rd$", ".html", file_in)
-  file_out[file_out == "index.html"] <- "index-topic.html"
+  file_out <- rd_output_path(file_in)
 
   funs <- purrr::map(rd, topic_funs)
 
@@ -249,6 +247,12 @@ package_topics <- function(path = ".", package = "pkgdown") {
   )
 }
 
+rd_output_path <- function(x) {
+  x <- gsub("\\.Rd$", ".html", x)
+  x[x == "index.html"] <- "index-topic.html"
+  x
+}
+
 package_rd <- function(path = ".") {
   man_path <- path(path, "man")
 
@@ -331,17 +335,19 @@ package_vignettes <- function(path = ".") {
   out[order(basename(out$file_out)), ]
 }
 
-find_template_config <- function(package, bs_version = NULL) {
+find_template_config <- function(package,
+                                 bs_version = NULL,
+                                 error_call = caller_env()) {
   if (is.null(package)) {
     return(list())
   }
 
   config <- path_package_pkgdown(
     "_pkgdown.yml",
-    package = package,
-    bs_version = bs_version
+    package,
+    bs_version,
+    error_call = error_call
   )
-
   if (!file_exists(config)) {
     return(list())
   }
diff --git a/R/pkgdown_print.R b/R/pkgdown_print.R
index 0a107cee8..f0e6f4ea8 100644
--- a/R/pkgdown_print.R
+++ b/R/pkgdown_print.R
@@ -40,3 +40,15 @@ pkgdown_print.htmlwidget <- function(x, visible = TRUE) {
   x$height <- x$height %||% (settings$fig.height * settings$dpi)
   x
 }
+
+#' @export
+pkgdown_print.gt_tbl <- function(x, visible = TRUE) {
+  if (!visible) {
+    return(invisible())
+  }
+
+  htmltools::div(
+    class = "gt-table",
+    gt::as_raw_html(x)
+  )
+}
diff --git a/R/rd-data.R b/R/rd-data.R
index 55c325124..56c7550af 100644
--- a/R/rd-data.R
+++ b/R/rd-data.R
@@ -65,7 +65,7 @@ as_data.tag_section <- function(x, ...) {
 as_data.tag_arguments <- function(x, ...) {
   list(
     title = tr_("Arguments"),
-    contents = describe_contents(x, ...)
+    contents = describe_contents(x, ..., id_prefix = "arg-")
   )
 }
 
@@ -77,7 +77,7 @@ as_data.tag_value <- function(x, ...) {
   )
 }
 
-describe_contents <- function(x, ...) {
+describe_contents <- function(x, ..., id_prefix = NULL) {
   # Drop pure whitespace nodes between items
   is_ws <- purrr::map_lgl(x, is_whitespace)
 
@@ -90,7 +90,7 @@ describe_contents <- function(x, ...) {
     if (length(x) == 0) {
       NULL
     } else if (any(purrr::map_lgl(x, inherits, "tag_item"))) {
-      paste0("<dl>\n", parse_descriptions(x, ...), "</dl>")
+      paste0("<dl>\n", parse_descriptions(x, ..., id_prefix = id_prefix), "</dl>")
     } else {
       flatten_para(x, ...)
     }
diff --git a/R/rd-html.R b/R/rd-html.R
index b99557d14..958e40c27 100644
--- a/R/rd-html.R
+++ b/R/rd-html.R
@@ -366,16 +366,27 @@ parse_items <- function(rd, ...) {
     paste(collapse = "")
 }
 
-parse_descriptions <- function(rd, ...) {
+parse_descriptions <- function(rd, ..., id_prefix = NULL) {
   if (length(rd) == 0) {
     return(character())
   }
 
   parse_item <- function(x) {
     if (inherits(x, "tag_item")) {
+      term <- flatten_text(x[[1]], ...)
+      def <- flatten_para(x[[2]], ...)
+    
+      if (!is.null(id_prefix)) {
+        id <- paste0(id_prefix, make_slug(term))
+        id_attr <- paste0(" id='", id, "'")
+        anchor <- anchor_html(id)
+      } else {
+        id_attr <- ""
+        anchor <- ""
+      }
       paste0(
-        "<dt>", flatten_text(x[[1]], ...), "</dt>\n",
-        "<dd>", flatten_para(x[[2]], ...), "</dd>\n"
+        "<dt", id_attr, ">", term, anchor, "</dt>\n",
+        "<dd>", def , "</dd>\n"
       )
     } else {
       flatten_text(x, ...)
diff --git a/R/repo.R b/R/repo.R
index 6342051bc..839927d3e 100644
--- a/R/repo.R
+++ b/R/repo.R
@@ -20,9 +20,11 @@ repo_source <- function(pkg, paths) {
     return()
   }
 
+  needs_slash <- !grepl("/$", url$source) & !grepl("^/", paths)
+
   links <- a(
     paste0("<code>", escape_html(paths), "</code>"),
-    paste0(url$source, paths)
+    paste0(url$source, ifelse(needs_slash, "/", ""), paths)
   )
 
   n <- length(links)
diff --git a/R/rmarkdown.R b/R/rmarkdown.R
index d8641d986..c7df55ba4 100644
--- a/R/rmarkdown.R
+++ b/R/rmarkdown.R
@@ -100,15 +100,12 @@ rmarkdown_render_with_seed <- function(..., seed = NULL) {
     if (requireNamespace("htmlwidgets", quietly = TRUE)) {
       htmlwidgets::setWidgetIdSeed(seed)
     }
-
-    # since envir is copied from the parent fn into callr::r_safe(),
-    # set.seed() sets the seed in the wrong global env and we have to
-    # manually copy it over
-    # if (!identical(envir, globalenv())) {
-    #   envir$.Random.seed <- .GlobalEnv$.Random.seed
-    # }
   }
- 
+
+  # Ensure paths from output are not made relative to input
+  # https://github.com/yihui/knitr/issues/2171
+  options(knitr.graphics.rel_path = FALSE)
+
   rmarkdown::render(envir = globalenv(), ...)
 }
 
diff --git a/R/templates.R b/R/templates.R
index 54816e4e5..4f51ff822 100644
--- a/R/templates.R
+++ b/R/templates.R
@@ -54,7 +54,7 @@ templates_dir <- function(pkg = list()) {
     }
     path_abs(template$path, start = pkg$src_path)
   } else if (!is.null(template$package)) {
-    path_package_pkgdown("templates", package = template$package, bs_version = pkg$bs_version)
+    path_package_pkgdown("templates", template$package, pkg$bs_version)
   } else {
     path(pkg$src_path, "pkgdown", "templates")
   }
diff --git a/R/test.R b/R/test.R
index e63affb14..366596151 100644
--- a/R/test.R
+++ b/R/test.R
@@ -82,6 +82,15 @@ NULL
 #' text(2, 5, "Hello", srt = 30, cex = 2)
 NULL
 
+#' Test case: tables
+#'
+#' @name test-tables
+#' @keywords internal
+#' @family tests
+#' @examples
+#' gt::gt(head(mtcars))
+NULL
+
 #' Test case: don't
 #'
 #' @name test-dont
diff --git a/R/theme.R b/R/theme.R
index d3f188584..265b5082e 100644
--- a/R/theme.R
+++ b/R/theme.R
@@ -68,11 +68,7 @@ bs_theme_rules <- function(pkg) {
 
   package <- purrr::pluck(pkg, "meta", "template", "package")
   if (!is.null(package)) {
-    package_extra <- path_package_pkgdown(
-      "extra.scss",
-      package = package,
-      bs_version = pkg$bs_version
-    )
+    package_extra <- path_package_pkgdown("extra.scss", package, pkg$bs_version)
     if (file_exists(package_extra)) {
       paths <- c(paths, package_extra)
     }
diff --git a/R/tweak-tags.R b/R/tweak-tags.R
index b61698ecd..d6a962b39 100644
--- a/R/tweak-tags.R
+++ b/R/tweak-tags.R
@@ -22,9 +22,7 @@ tweak_anchors <- function(html) {
   xml2::xml_attr(headings, "id") <- new_id
 
   # Insert anchors
-  anchor <- paste0(
-    "<a class='anchor' aria-label='anchor' href='#", new_id, "'></a>"
-  )
+  anchor <- anchor_html(new_id)
   for (i in seq_along(headings)) {
     heading <- headings[[i]]
     if (length(xml2::xml_contents(heading)) == 0) {
@@ -37,6 +35,10 @@ tweak_anchors <- function(html) {
   invisible()
 }
 
+anchor_html <- function(id) {
+  paste0("<a class='anchor' aria-label='anchor' href='#", id, "'></a>")
+}
+
 tweak_link_md <- function(html) {
   links <- xml2::xml_find_all(html, ".//a")
   if (length(links) == 0)
diff --git a/R/utils-fs.R b/R/utils-fs.R
index 20b669fc6..cb6f29f9b 100644
--- a/R/utils-fs.R
+++ b/R/utils-fs.R
@@ -1,53 +1,55 @@
-dir_copy_to <- function(pkg, from, to, overwrite = TRUE) {
-  stopifnot(length(to) == 1)
-  new_path <- function(path) {
-    path_abs(path_rel(path, start = from), start = to)
+dir_copy_to <- function(src_dir, 
+                        dst_dir, 
+                        src_root,
+                        dst_root,
+                        src_label = "",
+                        dst_label = "") {
+  check_string(src_dir)
+  check_string(dst_dir)
+
+  if (!dir_exists(src_dir)) {
+    return()
   }
 
-  contents <- dir_ls(from, recurse = TRUE)
-  is_dir <- fs::is_dir(contents)
+  src_paths <- dir_ls(src_dir, recurse = TRUE)
+  is_dir <- fs::is_dir(src_paths)
+  
+  dst_paths <- path(dst_dir, path_rel(src_paths, src_dir))
 
   # First create directories
-  dir_create(to)
-  dirs <- contents[is_dir]
-  dir_create(new_path(dirs))
-
+  dir_create(dst_paths[is_dir])
   # Then copy files
-  file_copy_to(pkg, contents[!is_dir],
-    to_dir = to,
-    from_dir = from,
-    overwrite = overwrite
+  file_copy_to(
+    src_paths = src_paths[!is_dir],
+    dst_paths = dst_paths[!is_dir],
+    src_root = src_root,
+    dst_root = dst_root,
+    src_label = src_label,
+    dst_label = dst_label
   )
 }
 
-# Would be better to base on top of data structure that provides both
-# files and root directory to use for printing
-file_copy_to <- function(pkg,
-                         from_paths,
-                         to_dir = pkg$dst_path,
-                         from_dir = path_common(from_paths),
-                         overwrite = TRUE) {
-
-  if (length(from_paths) == 0) {
-    return()
-  }
-
-  from_rel <- path_rel(from_paths, from_dir)
-  to_paths <- path_abs(from_rel, to_dir)
-
+file_copy_to <- function(src_paths,
+                         dst_paths,
+                         src_root,
+                         dst_root,
+                         src_label = "",
+                         dst_label = "") {
   # Ensure all the "to" directories exist
-  dirs_to_paths <- unique(fs::path_dir(to_paths))
-  dir_create(dirs_to_paths)
+  dst_dirs <- unique(fs::path_dir(dst_paths))
+  dir_create(dst_dirs)
 
-  eq <- purrr::map2_lgl(from_paths, to_paths, file_equal)
+  eq <- purrr::map2_lgl(src_paths, dst_paths, file_equal)
   if (any(!eq)) {
-    cli::cli_inform(c(
-        "Copying {src_path(path_rel(from_paths[!eq], pkg$src_path))}",
-        " to {dst_path(path_rel(to_paths[!eq], pkg$dst_path))}"
-    ))
+    src <- paste0(src_label, path_rel(src_paths[!eq], src_root))
+    dst <- paste0(dst_label, path_rel(dst_paths[!eq], dst_root))
+
+    purrr::walk2(src, dst, function(src, dst) {
+      cli::cli_inform("Copying {src_path(src)} to {dst_path(dst)}")
+    })
   }
 
-  file_copy(from_paths[!eq], to_paths[!eq], overwrite = overwrite)
+  file_copy(src_paths[!eq], dst_paths[!eq], overwrite = TRUE)
 }
 
 # Checks init_site() first.
@@ -94,19 +96,32 @@ path_first_existing <- function(...) {
   NULL
 }
 
-path_package_pkgdown <- function(..., package, bs_version = NULL) {
-  check_installed(package)
+path_package_pkgdown <- function(path,
+                                 package,
+                                 bs_version,
+                                 error_call = caller_env()) {
+  # package will usually be a github package, and check_installed()
+  # tries to install from CRAN, which is highly likely to fail.
+  if (!is_installed(package)) {
+    cli::cli_abort(
+      c(
+        "Template package {.val {package}} is not installed.",
+        i = "Please install before continuing."
+      ),
+      call = error_call
+    )
+  }
   base <- system_file("pkgdown", package = package)
 
   # If bs_version supplied, first try for versioned template
   if (!is.null(bs_version)) {
-    path <- path(base, paste0("BS", bs_version), ...)
-    if (file_exists(path)) {
-      return(path)
+    ver_path <- path(base, paste0("BS", bs_version), path)
+    if (file_exists(ver_path)) {
+      return(ver_path)
     }
   }
 
-  path(base, ...)
+  path(base, path)
 }
 
 path_pkgdown <- function(...) {
diff --git a/inst/BS5/assets/pkgdown.scss b/inst/BS5/assets/pkgdown.scss
index 3d71e45b1..7e14ebc11 100644
--- a/inst/BS5/assets/pkgdown.scss
+++ b/inst/BS5/assets/pkgdown.scss
@@ -1,8 +1,12 @@
 /* control page width ====================================================== */
 
-// Ensure contents never become unreadably wide
 .row > main {
+  // Ensure contents never become unreadably wide
   max-width: 50rem;
+  
+  // And that we can break and hypenate very long words
+  overflow-wrap: break-word;
+  hyphens: auto;
 }
 // Put extra space between content and navbar
 @include media-breakpoint-only(xl) {
@@ -232,8 +236,9 @@ body {
 
 // spacing tweaks
 dd {
-  margin-left: 1.5rem;
+  padding-left: 1.5rem;
 }
+
 summary {
   margin-bottom: 0.5rem;
 }
@@ -248,7 +253,9 @@ details {
 // Section anchors
 a.anchor {
   display: none;
-  margin-left: 5px;
+  // style like a footnote
+  margin-left: 2px;
+  vertical-align: top;
   width: Min(0.9em, 20px);
   height: Min(0.9em, 20px);
 
@@ -257,8 +264,20 @@ a.anchor {
   background-size: Min(0.9em, 20px) Min(0.9em, 20px);
   background-position: center center;
 }
-h2, h3, h4, h5, h6 {
-  &:hover .anchor {display: inline-block;}
+h2, h3, h4, h5, h6, dt {
+  &:hover .anchor, &:target .anchor {display: inline-block;}
+}
+
+// Give targetted arguments some visual distinction
+dt:target, dt:target + dd {
+  border-left: 0.25rem solid $primary;
+  margin-left: -0.75rem;
+}
+dt:target {
+  padding-left: 0.5rem;
+}
+dt:target + dd {
+  padding-left: 2rem;
 }
 
 // orcid badge
@@ -416,6 +435,12 @@ pre {
   padding: 1rem 0.5rem;
 }
 
+// Spacing tweaks for gt table
+pre div.gt-table {
+  white-space: normal;
+  margin-top: 1rem;
+}
+
 // "Pop" code out of page margins on small screens to give a little more room
 @include media-breakpoint-down(sm) {
   // div.section div.sourceCode pre
diff --git a/inst/rstudio/addins.dcf b/inst/rstudio/addins.dcf
index a801709b8..92ff5516d 100644
--- a/inst/rstudio/addins.dcf
+++ b/inst/rstudio/addins.dcf
@@ -1,4 +1,4 @@
-Name: Build pkgdown
-Description: Runs pkgdown on the current package
-Binding: build_site_external
+Name: Build full site
+Description: Build website for current package
+Binding: build_site
 Interactive: true
diff --git a/man/build_articles.Rd b/man/build_articles.Rd
index 756eec8a8..f77c93555 100644
--- a/man/build_articles.Rd
+++ b/man/build_articles.Rd
@@ -74,7 +74,6 @@ package, not the current source version. This makes iteration quicker when
 you are primarily working on the text of an article.
 }
 \section{Index and navbar}{
-
 You can control the articles index and navbar with a \code{articles} field in
 your \verb{_pkgdown.yml}. If you use it, pkgdown will check that all articles
 are included, and will error if you have missed any.
@@ -131,7 +130,6 @@ providing a drop-down.
 }
 
 \section{Get started}{
-
 Note that a vignette with the same name as the package (e.g.,
 \code{vignettes/pkgdown.Rmd} or \code{vignettes/articles/pkgdown.Rmd}) automatically
 becomes a top-level "Get started" link, and will not appear in the articles
@@ -139,10 +137,16 @@ drop-down.
 
 (If your package name includes a \code{.}, e.g. \code{pack.down}, use a \code{-} in the
 vignette name, e.g. \code{pack-down.Rmd}.)
+\subsection{Missing topics}{
+
+pkgdown will warn if there are (non-internal) articles that aren't listed
+in the articles index. You can suppress such warnings by listing the
+affected articles in a section with \code{title: internal} (case sensitive);
+this section will not be displayed on the index page.
+}
 }
 
 \section{External files}{
-
 pkgdown differs from base R in its handling of external files. When building
 vignettes, R assumes that vignettes are self-contained (a reasonable
 assumption when most vignettes were PDFs) and only copies files explicitly
@@ -164,7 +168,6 @@ generated figures as its default value is a strong assumption of rmarkdown.
 }
 
 \section{Embedding Shiny apps}{
-
 If you would like to embed a Shiny app into an article, the app will have
 to be hosted independently, (e.g. \url{https://www.shinyapps.io}). Then, you
 can embed the app into your article using an \verb{<iframe>}, e.g.
@@ -175,7 +178,6 @@ some hints on how to customise the appearance with CSS.
 }
 
 \section{Output formats}{
-
 By default, pkgdown builds all articles using the
 \code{\link[rmarkdown:html_document]{rmarkdown::html_document()}} \code{output} format, ignoring whatever is set in
 your YAML metadata. This is necessary because pkgdown has to integrate the
@@ -207,7 +209,6 @@ Additionally, htmlwidgets do not work when \code{as_is: true}.
 }
 
 \section{Suppressing vignettes}{
-
 If you want articles that are not vignettes, either put them in
 subdirectories or list in \code{.Rbuildignore}. An articles link will be
 automatically added to the default navbar if the vignettes directory is
@@ -216,8 +217,6 @@ present: if you do not want this, you will need to customise the navbar. See
 }
 
 \section{Figures}{
-
-
 You can control the default rendering of figures by specifying the \code{figures}
 field in \verb{_pkgdown.yml}. The default settings are equivalent to:
 
diff --git a/man/build_home.Rd b/man/build_home.Rd
index 6c5224112..a06f06596 100644
--- a/man/build_home.Rd
+++ b/man/build_home.Rd
@@ -87,11 +87,7 @@ in a level-one heading:
 \code{\link[=init_site]{init_site()}} will also automatically create a favicon set from your package logo.
 }
 
-\subsection{YAML config - home}{
-
-To tweak the home page, you need a section of the configuration file called
-\code{home}.
-\subsection{Page title and description}{
+\subsection{YAML config - title and description}{
 
 By default, the page title and description are extracted automatically from
 the \code{Title} and \code{Description} fields \code{DESCRIPTION} (stripping single quotes
@@ -108,9 +104,8 @@ findable on search engines, it's good practice to override the \code{title} and
     to your growing collection.
 }\if{html}{\out{</div>}}
 
-(Note the use of YAML's \code{>} i.e. "YAML pipes"; this is a convenient way of writing paragraphs of text.)
-}
-
+(Note the use of YAML's \code{>} i.e. "YAML pipes"; this is a convenient way of
+writing paragraphs of text.)
 }
 
 \subsection{Dev badges}{
@@ -173,9 +168,10 @@ authors page.
 }\if{html}{\out{</div>}}
 }
 
-\subsection{YAML config - authors}{
+\subsection{Additional control via YAML}{
 
-You can tweak a few things via the \code{authors} YAML field:
+You can control additinal aspects of the authors display via the \code{authors}
+YAML field:
 \itemize{
 \item display of each author in the footer, sidebar and authors page,
 \item which authors (by role) are displayed in the sidebar and footer,
diff --git a/man/build_news.Rd b/man/build_news.Rd
index 60515ce2e..4da4a3196 100644
--- a/man/build_news.Rd
+++ b/man/build_news.Rd
@@ -54,8 +54,6 @@ be added to the heading (see below for how to suppress); if not
 available on CRAN, "Unreleased" will be added.
 }
 \section{YAML config}{
-
-
 To automatically link to release announcements, include a \code{releases}
 section.
 
diff --git a/man/build_redirects.Rd b/man/build_redirects.Rd
new file mode 100644
index 000000000..b3eb55270
--- /dev/null
+++ b/man/build_redirects.Rd
@@ -0,0 +1,34 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/build-redirects.R
+\name{build_redirects}
+\alias{build_redirects}
+\title{Build redirects}
+\usage{
+build_redirects(pkg = ".", override = list())
+}
+\arguments{
+\item{pkg}{Path to package.}
+
+\item{override}{An optional named list used to temporarily override
+values in \verb{_pkgdown.yml}}
+}
+\description{
+If you change the structure of your documentation (by renaming vignettes or
+help topics) you can setup redirects from the old content to the new content.
+One or several now-absent pages can be redirected to a new page (or to a new
+section of a new page). This works by creating a html page that performs a
+"meta refresh", which isn't the best way of doing a redirect but works
+everywhere that you might deploy your site.
+
+The syntax is the following, with old paths on the left, and new paths or
+URLs on the right.
+
+\if{html}{\out{<div class="sourceCode yaml">}}\preformatted{redirects:
+  - ["articles/old-vignette-name.html", "articles/new-vignette-name.html"]
+  - ["articles/another-old-vignette-name.html", "articles/new-vignette-name.html"]
+  - ["articles/yet-another-old-vignette-name.html", "https://pkgdown.r-lib.org/dev"]
+}\if{html}{\out{</div>}}
+
+If for some reason you choose to redirect an existing page make sure to
+exclude it from the search index, see \code{?build_search}.
+}
diff --git a/man/build_reference.Rd b/man/build_reference.Rd
index 0e787ae57..980512c70 100644
--- a/man/build_reference.Rd
+++ b/man/build_reference.Rd
@@ -56,7 +56,6 @@ alphabetical order. To override this, provide a \code{reference} section in your
 \verb{_pkgdown.yml} as described below.
 }
 \section{Reference index}{
-
 To tweak the index page, add a section called \code{reference} to \verb{_pkgdown.yml}.
 It can contain three different types of element:
 \itemize{
@@ -158,17 +157,14 @@ a top-level \code{icons} directory. This should contain \code{.png} files that a
 either 30x30 (for regular display) or 60x60 (if you want retina display).
 Icons are matched to topics by aliases.
 }
+}
 
-\subsection{Examples}{
-
+\section{Examples}{
 If you need to run extra code before or after all examples are run, you
 can create \code{pkgdown/pre-reference.R} and \code{pkgdown/post-reference.R}.
 }
-}
 
 \section{Figures}{
-
-
 You can control the default rendering of figures by specifying the \code{figures}
 field in \verb{_pkgdown.yml}. The default settings are equivalent to:
 
diff --git a/man/build_search.Rd b/man/build_search.Rd
index babca8d91..4d2fc04fe 100644
--- a/man/build_search.Rd
+++ b/man/build_search.Rd
@@ -16,7 +16,6 @@ values in \verb{_pkgdown.yml}}
 Build a JSON file encompassing all HTML pages, for use by the search script.
 }
 \section{YAML config}{
-
 You can exclude some paths from the search index.
 Below we exclude the changelog from the search index.
 
@@ -26,8 +25,6 @@ Below we exclude the changelog from the search index.
 }
 
 \section{Debugging and local testing}{
-
-
 Locally (as opposed to on GitHub Pages or Netlify for instance),
 search won't work if you simply use pkgdown preview of the static files.
 You can use \code{servr::httw("docs")} instead.
diff --git a/man/build_site.Rd b/man/build_site.Rd
index 4d104d0c0..e79c04b04 100644
--- a/man/build_site.Rd
+++ b/man/build_site.Rd
@@ -69,6 +69,7 @@ so it is available for vignettes.}
 \item \code{\link[=build_articles]{build_articles()}}
 \item \code{\link[=build_tutorials]{build_tutorials()}}
 \item \code{\link[=build_news]{build_news()}}
+\item \code{\link[=build_redirects]{build_redirects()}}
 }
 
 See the documentation for the each function to learn how to control
@@ -106,7 +107,6 @@ documented in \code{vignette("search")}.
 }
 
 \section{Development mode}{
-
 The \code{development} field allows you to generate different sites for the
 development and released versions of your package. To use it, you first
 need to set the development \code{mode}:
@@ -116,21 +116,22 @@ need to set the development \code{mode}:
 }\if{html}{\out{</div>}}
 \subsection{Setting development mode}{
 
-The development \code{mode} of a site controls where the site is built,
-the colour of the package version in the navbar, the version tooltip,
-and whether or not the site is indexed by search engines. There are
-four possible modes:
+The development \code{mode} of a site controls where the built site is placed
+and how it is styled (i.e. the colour of the package version in the
+navbar, the version tooltip), and whether or not the site is indexed by
+search engines. There are four possible modes:
 \itemize{
-\item \strong{automatic} (\code{mode: auto}): automatically determines the mode based on the
-version number:
+\item \strong{automatic} (\code{mode: auto}): determines the mode based on the version:
 \itemize{
 \item \verb{0.0.0.9000} (\verb{0.0.0.*}): unreleased.
 \item four version components: development.
 \item everything else -> release.
 }
-\item \strong{release} (\code{mode: release}), the default. Site is written to \verb{docs/}.
-Version in navbar gets the default colouring. Development badges are
-not shown in the sidebar (see \code{?build_home}).
+\item \strong{release} (\code{mode: release}), the default. Site is written to \verb{docs/}
+and styled like a released package, even if the content is for an
+unreleased or development version. Version in navbar gets the default
+colouring. Development badges are not shown in the sidebar
+(see \code{?build_home}).
 \item \strong{development} (\code{mode: devel}). Site is written to \verb{docs/dev/}.
 The navbar version gets a "danger" class and a tooltip stating these are
 docs for an in-development version of the package. The \code{noindex} meta tag
@@ -142,6 +143,10 @@ package is not yet on CRAN.
 Development badges are shown in the sidebar (see \code{?build_home}).
 }
 
+Use \code{mode: auto} if you want both a released and a dev site, and
+\code{mode: release} if you just want a single site. It is very rare that you
+will need either devel or unreleased modes.
+
 You can override the mode specified in the \verb{_pkgdown.yml} by setting
 by setting \code{PKGDOWN_DEV_MODE} to \code{devel} or \code{release}.
 }
@@ -194,11 +199,11 @@ to danger). Finally, you can choose to override the default tooltip with
 }
 
 \section{Template}{
-
 The \code{template} field is mostly used to control the appearance of the site.
-See \code{vignette("customise")} for details.
+See \code{vignette("customise")} for details. But it's also used to control
+\subsection{Other aspects}{
 
-There are two other \code{template} fields that control other aspects of the
+There are a few other \code{template} fields that control other aspects of the
 site:
 \itemize{
 \item \code{noindex: true} will suppress indexing of your pages by search engines:
@@ -224,8 +229,7 @@ redirect scenarios.
 }
 }
 
-\section{Analytics}{
-
+\subsection{Analytics}{
 
 To capture usage of your site with a web analytics tool, you can make
 use of the \code{includes} field to add the special HTML they need. This HTML
@@ -268,9 +272,9 @@ recommend getting the HTML directly from the tool:
 }\if{html}{\out{</div>}}
 }
 }
+}
 
 \section{Source repository}{
-
 Use the \code{repo} field to override pkgdown's automatically discovery
 of your source repository. This is used in the navbar, on the homepage,
 in articles and reference topics, and in the changelog (to link to issue
@@ -317,7 +321,6 @@ specifying a branch name:
 }
 
 \section{Deployment (\code{deploy})}{
-
 There is a single \code{deploy} field
 \itemize{
 \item \code{install_metadata} allows you to install package index metadata into
@@ -332,30 +335,7 @@ time (e.g. because behind a firewall or requires auth).
 }
 }
 
-\section{Redirects}{
-
-If you change the structure of your documentation (by renaming vignettes or
-help topics) you can setup redirects from the old content to the new content.
-One or several now-absent pages can be redirected to a new page (or to a new
-section of a new page). This works by creating a html page that performs a
-"meta refresh", which isn't the best way of doing a redirect but works
-everywhere that you might deploy your site.
-
-The syntax is the following, with old paths on the left, and new paths or
-URLs on the right.
-
-\if{html}{\out{<div class="sourceCode yaml">}}\preformatted{redirects:
-  - ["articles/old-vignette-name.html", "articles/new-vignette-name.html"]
-  - ["articles/another-old-vignette-name.html", "articles/new-vignette-name.html"]
-  - ["articles/yet-another-old-vignette-name.html", "https://pkgdown.r-lib.org/dev"]
-}\if{html}{\out{</div>}}
-
-If for some reason you choose to redirect an existing page make sure to
-exclude it from the search index, see \code{?build_search}.
-}
-
 \section{Options}{
-
 Users with limited internet connectivity can disable CRAN checks by setting
 \code{options(pkgdown.internet = FALSE)}. This will also disable some features
 from pkgdown that requires an internet connectivity. However, if it is used
diff --git a/man/build_tutorials.Rd b/man/build_tutorials.Rd
index 5046f902b..1d7abe923 100644
--- a/man/build_tutorials.Rd
+++ b/man/build_tutorials.Rd
@@ -24,7 +24,6 @@ Tutorials are automatically discovered from published tutorials in
 list in \verb{_pkgdown.yml} as described below.
 }
 \section{YAML config}{
-
 To override the default discovery process, you can provide a \code{tutorials}
 section. This should be a list where each element specifies:
 \itemize{
diff --git a/man/index.Rd b/man/index.Rd
index fd33381c6..71dc7bcba 100644
--- a/man/index.Rd
+++ b/man/index.Rd
@@ -18,6 +18,7 @@ Other tests:
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/init_site.Rd b/man/init_site.Rd
index 4046c1500..7d638ddf6 100644
--- a/man/init_site.Rd
+++ b/man/init_site.Rd
@@ -22,7 +22,6 @@ See \code{vignette("customise")} for the various ways you can customise the
 display of your site.
 }
 \section{Build-ignored files}{
-
 We recommend using \code{\link[usethis:use_pkgdown]{usethis::use_pkgdown()}} to build-ignore \verb{docs/} and
 \verb{_pkgdown.yml}. If use another directory, or create the site manually,
 you'll need to add them to \code{.Rbuildignore} yourself. A \code{NOTE} about
diff --git a/man/test-crayon.Rd b/man/test-crayon.Rd
index 3a159568b..aa779cb85 100644
--- a/man/test-crayon.Rd
+++ b/man/test-crayon.Rd
@@ -25,6 +25,7 @@ Other tests:
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-dont.Rd b/man/test-dont.Rd
index 804b68984..a8be6493b 100644
--- a/man/test-dont.Rd
+++ b/man/test-dont.Rd
@@ -56,6 +56,7 @@ Other tests:
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-figures.Rd b/man/test-figures.Rd
index 5ca5d8b37..208b1a3e6 100644
--- a/man/test-figures.Rd
+++ b/man/test-figures.Rd
@@ -25,6 +25,7 @@ Other tests:
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-links.Rd b/man/test-links.Rd
index 493b035e9..6c6a9b3af 100644
--- a/man/test-links.Rd
+++ b/man/test-links.Rd
@@ -25,6 +25,7 @@ Other tests:
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-lists.Rd b/man/test-lists.Rd
index 88cbc3a54..edef2f8c7 100644
--- a/man/test-lists.Rd
+++ b/man/test-lists.Rd
@@ -58,6 +58,7 @@ Other tests:
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-long-lines.Rd b/man/test-long-lines.Rd
index 869cd3888..39cd7cb03 100644
--- a/man/test-long-lines.Rd
+++ b/man/test-long-lines.Rd
@@ -26,6 +26,7 @@ Other tests:
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-output-styles.Rd b/man/test-output-styles.Rd
index e7655192f..674cdc0ef 100644
--- a/man/test-output-styles.Rd
+++ b/man/test-output-styles.Rd
@@ -33,6 +33,7 @@ Other tests:
 \code{\link{test-long-lines}},
 \code{\link{test-params}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-params.Rd b/man/test-params.Rd
index 3c75c26f7..3439897b3 100644
--- a/man/test-params.Rd
+++ b/man/test-params.Rd
@@ -20,6 +20,7 @@ Other tests:
 \code{\link{test-long-lines}},
 \code{\link{test-output-styles}},
 \code{\link{test-sexpr-title}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-sexpr-title.Rd b/man/test-sexpr-title.Rd
index 039fbf19d..ad502afa3 100644
--- a/man/test-sexpr-title.Rd
+++ b/man/test-sexpr-title.Rd
@@ -17,6 +17,7 @@ Other tests:
 \code{\link{test-long-lines}},
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
+\code{\link{test-tables}},
 \code{\link{test-verbatim}}
 }
 \concept{tests}
diff --git a/man/test-tables.Rd b/man/test-tables.Rd
new file mode 100644
index 000000000..5a27a2ad9
--- /dev/null
+++ b/man/test-tables.Rd
@@ -0,0 +1,27 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/test.R
+\name{test-tables}
+\alias{test-tables}
+\title{Test case: tables}
+\description{
+Test case: tables
+}
+\examples{
+gt::gt(head(mtcars))
+}
+\seealso{
+Other tests: 
+\code{\link{index}},
+\code{\link{test-crayon}},
+\code{\link{test-dont}},
+\code{\link{test-figures}},
+\code{\link{test-links}},
+\code{\link{test-lists}},
+\code{\link{test-long-lines}},
+\code{\link{test-output-styles}},
+\code{\link{test-params}},
+\code{\link{test-sexpr-title}},
+\code{\link{test-verbatim}}
+}
+\concept{tests}
+\keyword{internal}
diff --git a/man/test-verbatim.Rd b/man/test-verbatim.Rd
index 96d22b3c3..a2d74128b 100644
--- a/man/test-verbatim.Rd
+++ b/man/test-verbatim.Rd
@@ -47,7 +47,8 @@ Other tests:
 \code{\link{test-long-lines}},
 \code{\link{test-output-styles}},
 \code{\link{test-params}},
-\code{\link{test-sexpr-title}}
+\code{\link{test-sexpr-title}},
+\code{\link{test-tables}}
 }
 \concept{tests}
 \keyword{internal}
diff --git a/pkgdown/_pkgdown.yml b/pkgdown/_pkgdown.yml
index 74a8c8353..1cecac508 100644
--- a/pkgdown/_pkgdown.yml
+++ b/pkgdown/_pkgdown.yml
@@ -53,13 +53,8 @@ reference:
   desc:  Build a complete site or one of its components.
   contents:
   - build_site
-  - build_articles
-  - build_favicons
-  - build_home
-  - build_news
-  - build_tutorials
-  - build_reference
-  - build_search
+  - starts_with("build_")
+  - -build_site_github_pages
   - init_site
   - preview_site
   - pkgdown_sitrep
diff --git a/tests/testthat/_snaps/build-articles.md b/tests/testthat/_snaps/build-articles.md
index f64bcaa2a..a77c7bae4 100644
--- a/tests/testthat/_snaps/build-articles.md
+++ b/tests/testthat/_snaps/build-articles.md
@@ -1,21 +1,3 @@
-# links to man/figures are automatically relocated
-
-    Code
-      copy_figures(pkg)
-    Message
-      Copying man/figures/kitten.jpg
-      to reference/figures/kitten.jpg
-
----
-
-    Code
-      build_articles(pkg, lazy = FALSE)
-    Message
-      -- Building articles -----------------------------------------------------------
-      Writing `articles/index.html`
-      Reading vignettes/kitten.Rmd
-      Writing `articles/kitten.html`
-
 # warns about missing images
 
     Code
@@ -116,6 +98,7 @@
       build_redirects(pkg)
     Message
       -- Building redirects ----------------------------------------------------------
+      Adding redirect from articles/articles/nested.html to articles/nested.html.
 
 # pkgdown deps are included only once in articles
 
@@ -125,6 +108,14 @@
       Reading vignettes/html-deps.Rmd
       Writing `articles/html-deps.html`
 
+# warns about articles missing from index
+
+    Code
+      . <- data_articles_index(pkg)
+    Condition
+      Error:
+      ! 1 vignette missing from index in _pkgdown.yml: "c".
+
 # output is reproducible by default, i.e. 'seed' is respected
 
     Code
diff --git a/tests/testthat/_snaps/build-logo.md b/tests/testthat/_snaps/build-logo.md
index bf005edad..60cf0e1d8 100644
--- a/tests/testthat/_snaps/build-logo.md
+++ b/tests/testthat/_snaps/build-logo.md
@@ -3,6 +3,5 @@
     Code
       copy_logo(pkg)
     Message
-      Copying man/figures/logo.svg
-      to logo.svg
+      Copying man/figures/logo.svg to logo.svg
 
diff --git a/tests/testthat/_snaps/build-redirects.md b/tests/testthat/_snaps/build-redirects.md
index be5850182..c1d750d55 100644
--- a/tests/testthat/_snaps/build-redirects.md
+++ b/tests/testthat/_snaps/build-redirects.md
@@ -1,3 +1,10 @@
+# build_redirect() works
+
+    Code
+      build_redirect(c("old.html", "new.html#section"), 1, pkg = pkg)
+    Message
+      Adding redirect from old.html to new.html#section.
+
 # build_redirect() errors if one entry is not right.
 
     Code
diff --git a/tests/testthat/_snaps/build-search-docs.md b/tests/testthat/_snaps/build-search-docs.md
new file mode 100644
index 000000000..8b97b6be3
--- /dev/null
+++ b/tests/testthat/_snaps/build-search-docs.md
@@ -0,0 +1,10 @@
+# url_node gives informative error
+
+    Code
+      url_node("<")
+    Condition
+      Error in `url_node()`:
+      ! Failed to wrap URL "<"
+      Caused by error in `read_xml.raw()`:
+      ! StartTag: invalid element name [68]
+
diff --git a/tests/testthat/_snaps/init.md b/tests/testthat/_snaps/init.md
index 953b138c4..ffc67baba 100644
--- a/tests/testthat/_snaps/init.md
+++ b/tests/testthat/_snaps/init.md
@@ -1,3 +1,18 @@
+# informative print method
+
+    Code
+      init_site(pkg)
+    Message
+      -- Initialising site -----------------------------------------------------------
+      Copying <pkgdown>/BS3/assets/bootstrap-toc.css to bootstrap-toc.css
+      Copying <pkgdown>/BS3/assets/bootstrap-toc.js to bootstrap-toc.js
+      Copying <pkgdown>/BS3/assets/docsearch.css to docsearch.css
+      Copying <pkgdown>/BS3/assets/docsearch.js to docsearch.js
+      Copying <pkgdown>/BS3/assets/link.svg to link.svg
+      Copying <pkgdown>/BS3/assets/pkgdown.css to pkgdown.css
+      Copying <pkgdown>/BS3/assets/pkgdown.js to pkgdown.js
+      Copying pkgdown/extra.css to extra.css
+
 # site meta doesn't break unexpectedly
 
     Code
diff --git a/tests/testthat/_snaps/rd-html.md b/tests/testthat/_snaps/rd-html.md
index 02e009aa7..a97d8f783 100644
--- a/tests/testthat/_snaps/rd-html.md
+++ b/tests/testthat/_snaps/rd-html.md
@@ -86,6 +86,18 @@
     <p>Paragraph 2</p></dd>
     
     
+    </dl>
+
+# can add ids to descriptions
+
+    <dl>
+    <dt id='fooabc'>abc<a class='anchor' aria-label='anchor' href='#fooabc'></a></dt>
+    <dd><p>Contents 1</p></dd>
+    
+    <dt id='fooxyz'>xyz<a class='anchor' aria-label='anchor' href='#fooxyz'></a></dt>
+    <dd><p>Contents 2</p></dd>
+    
+    
     </dl>
 
 # nested item with whitespace parsed correctly
diff --git a/tests/testthat/_snaps/utils-fs.md b/tests/testthat/_snaps/utils-fs.md
new file mode 100644
index 000000000..b83869d86
--- /dev/null
+++ b/tests/testthat/_snaps/utils-fs.md
@@ -0,0 +1,9 @@
+# missing template package yields custom error
+
+    Code
+      path_package_pkgdown("x", "missing", 3)
+    Condition
+      Error:
+      ! Template package "missing" is not installed.
+      i Please install before continuing.
+
diff --git a/tests/testthat/assets/man-figures/.gitignore b/tests/testthat/assets/articles-images/.gitignore
similarity index 100%
rename from tests/testthat/assets/man-figures/.gitignore
rename to tests/testthat/assets/articles-images/.gitignore
diff --git a/tests/testthat/assets/man-figures/DESCRIPTION b/tests/testthat/assets/articles-images/DESCRIPTION
similarity index 100%
rename from tests/testthat/assets/man-figures/DESCRIPTION
rename to tests/testthat/assets/articles-images/DESCRIPTION
diff --git a/tests/testthat/assets/man-figures/README.md b/tests/testthat/assets/articles-images/README.md
similarity index 100%
rename from tests/testthat/assets/man-figures/README.md
rename to tests/testthat/assets/articles-images/README.md
diff --git a/tests/testthat/assets/man-figures/_pkgdown.yml b/tests/testthat/assets/articles-images/_pkgdown.yml
similarity index 100%
rename from tests/testthat/assets/man-figures/_pkgdown.yml
rename to tests/testthat/assets/articles-images/_pkgdown.yml
diff --git a/tests/testthat/assets/man-figures/man-figures.Rproj b/tests/testthat/assets/articles-images/man-figures.Rproj
similarity index 100%
rename from tests/testthat/assets/man-figures/man-figures.Rproj
rename to tests/testthat/assets/articles-images/man-figures.Rproj
diff --git a/tests/testthat/assets/man-figures/man/figures/kitten.jpg b/tests/testthat/assets/articles-images/man/figures/kitten.jpg
similarity index 100%
rename from tests/testthat/assets/man-figures/man/figures/kitten.jpg
rename to tests/testthat/assets/articles-images/man/figures/kitten.jpg
diff --git a/tests/testthat/assets/man-figures/man/kitten.Rd b/tests/testthat/assets/articles-images/man/kitten.Rd
similarity index 100%
rename from tests/testthat/assets/man-figures/man/kitten.Rd
rename to tests/testthat/assets/articles-images/man/kitten.Rd
diff --git a/tests/testthat/assets/man-figures/vignettes/.gitignore b/tests/testthat/assets/articles-images/vignettes/.gitignore
similarity index 100%
rename from tests/testthat/assets/man-figures/vignettes/.gitignore
rename to tests/testthat/assets/articles-images/vignettes/.gitignore
diff --git a/tests/testthat/assets/man-figures/vignettes/another-kitten.jpg b/tests/testthat/assets/articles-images/vignettes/another-kitten.jpg
similarity index 100%
rename from tests/testthat/assets/man-figures/vignettes/another-kitten.jpg
rename to tests/testthat/assets/articles-images/vignettes/another-kitten.jpg
diff --git a/tests/testthat/assets/man-figures/vignettes/kitten.Rmd b/tests/testthat/assets/articles-images/vignettes/kitten.Rmd
similarity index 70%
rename from tests/testthat/assets/man-figures/vignettes/kitten.Rmd
rename to tests/testthat/assets/articles-images/vignettes/kitten.Rmd
index 0481c299b..332ecf94b 100644
--- a/tests/testthat/assets/man-figures/vignettes/kitten.Rmd
+++ b/tests/testthat/assets/articles-images/vignettes/kitten.Rmd
@@ -20,10 +20,24 @@ knitr::opts_chunk$set(
 knitr::include_graphics("../man/figures/kitten.jpg")
 ```
 
+``` {r}
+knitr::include_graphics("another-kitten.jpg")
+```
+
 ## rmarkdown
 
 ![](../man/figures/kitten.jpg)
 
-## Another kitten
-
 ![](another-kitten.jpg)
+
+## External package
+
+```{r magick}
+magick::image_read("another-kitten.jpg")
+```
+
+## Plot
+
+```{r plot}
+plot(1:3)
+```
\ No newline at end of file
diff --git a/tests/testthat/assets/reference/R/funs.R b/tests/testthat/assets/reference/R/funs.R
index b3cd42500..a1f3b814d 100644
--- a/tests/testthat/assets/reference/R/funs.R
+++ b/tests/testthat/assets/reference/R/funs.R
@@ -1,7 +1,10 @@
 #' A
 #' @export
 #' @keywords foo
-a <- function() {}
+#' @param a a letter
+#' @param b a a number
+#' @param c a logical
+a <- function(a, b, c) {}
 
 #' B
 #' @export
diff --git a/tests/testthat/assets/reference/man/a.Rd b/tests/testthat/assets/reference/man/a.Rd
index c71c4950d..0a4c25842 100644
--- a/tests/testthat/assets/reference/man/a.Rd
+++ b/tests/testthat/assets/reference/man/a.Rd
@@ -4,7 +4,14 @@
 \alias{a}
 \title{A}
 \usage{
-a()
+a(a, b, c)
+}
+\arguments{
+\item{a}{a letter}
+
+\item{b}{a a number}
+
+\item{c}{a logical}
 }
 \description{
 A
diff --git a/tests/testthat/test-build-articles.R b/tests/testthat/test-build-articles.R
index 37f6c342b..a09134e25 100644
--- a/tests/testthat/test-build-articles.R
+++ b/tests/testthat/test-build-articles.R
@@ -5,21 +5,28 @@ test_that("can recognise intro variants", {
   expect_true(article_is_intro("articles/pack-age", "pack.age"))
 })
 
-test_that("links to man/figures are automatically relocated", {
+test_that("image links relative to output", {
   # weird path differences that I don't have the energy to dig into
   skip_on_cran()
-  pkg <- local_pkgdown_site(test_path("assets/man-figures"))
+  pkg <- local_pkgdown_site(test_path("assets/articles-images"))
 
-  expect_snapshot(copy_figures(pkg))
-  expect_snapshot(build_articles(pkg, lazy = FALSE))
+  suppressMessages(copy_figures(pkg))
+  suppressMessages(build_article("kitten", pkg))
 
   html <- xml2::read_html(path(pkg$dst_path, "articles", "kitten.html"))
   src <- xpath_attr(html, "//img", "src")
 
   expect_equal(src, c(
+    # knitr::include_graphics()
     "../reference/figures/kitten.jpg",
+    "another-kitten.jpg",
+    # rmarkdown image 
     "../reference/figures/kitten.jpg",
-    "another-kitten.jpg"
+    "another-kitten.jpg",
+    # magick::image_read()
+    "kitten_files/figure-html/magick-1.png",
+    # figure
+    "kitten_files/figure-html/plot-1.jpg"
   ))
 
   # And files aren't copied
@@ -199,6 +206,38 @@ test_that("pkgdown deps are included only once in articles", {
   expect_length(bs_css_href, 1)
 })
 
+test_that("warns about articles missing from index", {
+  pkg <- local_pkgdown_site()
+  write_lines(path = path(pkg$src_path, "_pkgdown.yml"), "
+    articles:
+    - title: External
+      contents: [a, b]
+  ")
+  dir_create(path(pkg$src_path, "vignettes"))
+  file_create(path(pkg$src_path, "vignettes", paste0(letters[1:3], ".Rmd")))
+  pkg <- as_pkgdown(pkg$src_path)
+
+  expect_snapshot(. <- data_articles_index(pkg), error = TRUE)
+})
+
+test_that("internal articles aren't included and don't trigger warning", {
+  pkg <- local_pkgdown_site()
+  write_lines(path = path(pkg$src_path, "_pkgdown.yml"), "
+    articles:
+    - title: External
+      contents: [a, b]
+    - title: internal
+      contents: c
+  ")
+  dir_create(path(pkg$src_path, "vignettes"))
+  file_create(path(pkg$src_path, "vignettes", paste0(letters[1:3], ".Rmd")))
+  pkg <- as_pkgdown(pkg$src_path)
+
+  expect_no_error(index <- data_articles_index(pkg))
+  expect_length(index$sections, 1)
+  expect_length(index$sections[[1]]$contents, 2)
+})
+
 test_that("check doesn't include getting started vignette", {
   pkg <- local_pkgdown_site(test_path("assets/articles-resources"))
   getting_started <- path(pkg$src_path, "vignettes", paste0(pkg$package, ".Rmd"))
diff --git a/tests/testthat/test-build-redirects.R b/tests/testthat/test-build-redirects.R
index 3e15f9067..2e89cfdc4 100644
--- a/tests/testthat/test-build-redirects.R
+++ b/tests/testthat/test-build-redirects.R
@@ -7,7 +7,9 @@ test_that("build_redirect() works", {
     bs_version = 5
   )
   pkg <- structure(pkg, class = "pkgdown")
-  build_redirect(c("old.html", "new.html#section"), 1, pkg = pkg)
+  expect_snapshot(
+    build_redirect(c("old.html", "new.html#section"), 1, pkg = pkg)
+  )
 
   html <- xml2::read_html(path(pkg$dst_path, "old.html"))
   expect_equal(
@@ -45,3 +47,48 @@ test_that("article_redirects() creates redirects for vignettes in vignettes/arti
     list(c("articles/articles/test.html", "articles/test.html"))
   )
 })
+
+# reference_redirects ----------------------------------------------------------
+
+test_that("generates redirects only for non-name aliases", {
+  pkg <- list(
+    meta = list(url = "http://foo.com"),
+    topics = list(
+      alias = list("foo", c("bar", "baz")),
+      name = c("foo", "bar"),
+      file_out = c("foo.html", "bar.html")
+    )
+  )
+  expect_equal(
+    reference_redirects(pkg),
+    list(c("reference/baz.html", "reference/bar.html"))
+  )
+})
+
+test_that("never redirects away from existing topic", {
+  pkg <- list(
+    meta = list(url = "http://foo.com"),
+    topics = list(
+      alias = list("foo", c("bar", "foo")),
+      name = c("foo", "bar"),
+      file_out = c("foo.html", "bar.html")
+    )
+  )
+  expect_equal(
+    reference_redirects(pkg),
+    list()
+  )
+})
+
+test_that("no redirects if no aliases", {
+  pkg <- list(
+    meta = list(url = "http://foo.com"),
+    topics = list(
+      alias = list(c("foo", "bar")),
+      name = c("foo", "bar"),
+      file_out = c("foo.html", "bar.html")
+    )
+  )
+  expect_equal(reference_redirects(pkg), list())
+})
+
diff --git a/tests/testthat/test-build-reference.R b/tests/testthat/test-build-reference.R
index 273fc0cb7..da6b49626 100644
--- a/tests/testthat/test-build-reference.R
+++ b/tests/testthat/test-build-reference.R
@@ -104,6 +104,15 @@ test_that("examples are reproducible by default, i.e. 'seed' is respected", {
   expect_snapshot(cat(examples))
 })
 
+test_that("arguments get individual ids", {
+  pkg <- local_pkgdown_site(test_path("assets/reference"))
+  suppressMessages(build_reference(pkg, topics = "a"))
+
+  html <- xml2::read_html(file.path(pkg$dst_path, "reference", "a.html"))
+  expect_equal(xpath_attr(html, "//dt", "id"), c("arg-a", "arg-b", "arg-c"))
+
+})
+
 test_that("title and page title escapes html", {
   pkg <- local_pkgdown_site(test_path("assets/reference"))
   suppressMessages(build_reference(pkg, topics = "g"))
diff --git a/tests/testthat/test-build-search-docs.R b/tests/testthat/test-build-search-docs.R
index 6bed9d790..b84632c5a 100644
--- a/tests/testthat/test-build-search-docs.R
+++ b/tests/testthat/test-build-search-docs.R
@@ -50,3 +50,7 @@ test_that("build_search() builds the expected search.json with no URL", {
   jsonlite::write_json(build_search_index(pkg), json_path, pretty = TRUE)
   expect_snapshot_file(json_path, "search-no-url.json")
 })
+
+test_that("url_node gives informative error", {
+  expect_snapshot(url_node("<"), error = TRUE)
+})
\ No newline at end of file
diff --git a/tests/testthat/test-init.R b/tests/testthat/test-init.R
index 65d8c3437..fa2904608 100644
--- a/tests/testthat/test-init.R
+++ b/tests/testthat/test-init.R
@@ -1,3 +1,8 @@
+test_that("informative print method", {
+  pkg <- local_pkgdown_site(test_path("assets/init-extra-1"))
+  expect_snapshot(init_site(pkg))
+})
+
 test_that("extra.css and extra.js copied and linked", {
   pkg <- local_pkgdown_site(test_path("assets/init-extra-2"))
   suppressMessages(init_site(pkg))
@@ -42,3 +47,15 @@ test_that("site meta doesn't break unexpectedly", {
 
   expect_snapshot(yaml)
 })
+
+test_that("site meta includes vignette subdirectories", {
+  pkg <- local_pkgdown_site()
+
+  vig_path <- path(pkg$src_path, "vignettes") 
+  dir_create(path(vig_path, "a"))
+  file_create(path(vig_path, "a", c("a.Rmd", "b.Rmd")))
+  pkg <- as_pkgdown(pkg$src_path)
+
+  meta <- site_meta(pkg)
+  expect_equal(meta$articles, list("a/a" = "a/a.html", "a/b" = "a/b.html"))
+})
\ No newline at end of file
diff --git a/tests/testthat/test-package.R b/tests/testthat/test-package.R
index d2f4528a4..ce3dd158a 100644
--- a/tests/testthat/test-package.R
+++ b/tests/testthat/test-package.R
@@ -55,7 +55,7 @@ test_that("package_vignettes() sorts articles alphabetically by file name", {
 })
 
 test_that("override works correctly for as_pkgdown", {
-  pkgdown <- as_pkgdown("assets/man-figures")
+  pkgdown <- as_pkgdown(test_path("assets/articles-images"))
   expected_list <- list(figures = list(dev = "jpeg", fig.ext = "jpg", fig.width = 3, fig.asp = 1))
   expect_equal(pkgdown$meta, expected_list)
   modified_pkgdown <- as_pkgdown(pkgdown, override = list(figures = list(dev = "png")))
diff --git a/tests/testthat/test-preview.R b/tests/testthat/test-preview.R
index 35ee01f93..74e261285 100644
--- a/tests/testthat/test-preview.R
+++ b/tests/testthat/test-preview.R
@@ -1,5 +1,5 @@
 test_that("checks its inputs", {
-  pkg <- local_pkgdown_site(test_path("assets/man-figures"))
+  pkg <- local_pkgdown_site(test_path("assets/articles-images"))
 
   expect_snapshot(error = TRUE, {
     preview_site(pkg, path = 1)
diff --git a/tests/testthat/test-rd-html.R b/tests/testthat/test-rd-html.R
index 1d77e8545..8584b84ff 100644
--- a/tests/testthat/test-rd-html.R
+++ b/tests/testthat/test-rd-html.R
@@ -355,6 +355,14 @@ test_that("\\describe items can contain multiple paragraphs", {
   expect_snapshot_output(cat(out, sep = "\n"))
 })
 
+test_that("can add ids to descriptions", {
+  out <- rd2html("\\describe{
+    \\item{abc}{Contents 1}
+    \\item{xyz}{Contents 2}
+  }", id_prefix = "foo")
+  expect_snapshot_output(cat(out, sep = "\n"))
+})
+
 test_that("\\describe items can contain multiple paragraphs", {
   out <- rd2html("\\describe{
     \\item{Label}{
diff --git a/tests/testthat/test-repo.R b/tests/testthat/test-repo.R
index bd7c1ec76..8ac2a0f40 100644
--- a/tests/testthat/test-repo.R
+++ b/tests/testthat/test-repo.R
@@ -56,6 +56,17 @@ test_that("repo_source() truncates automatically", {
   })
 })
 
+test_that("repo_source() is robust to trailing slash", {
+  pkg <- list(repo = repo_meta_gh_like("https://github.com/r-lib/pkgdown"))
+
+  meta <- function(x) {
+    list(repo = list(url = list(source = x)))
+  } 
+  source <- "Source: <a href='http://example.com/a'><code>a</code></a>"
+  expect_equal(repo_source(meta("http://example.com"), "a"), source)
+  expect_equal(repo_source(meta("http://example.com/"), "a"), source)
+})
+
 # repo_source with alternate default branch -------------------------------
 
 test_that("repo_source() uses the branch setting in meta", {
diff --git a/tests/testthat/test-utils-fs.R b/tests/testthat/test-utils-fs.R
new file mode 100644
index 000000000..59924d4cc
--- /dev/null
+++ b/tests/testthat/test-utils-fs.R
@@ -0,0 +1,3 @@
+test_that("missing template package yields custom error", {
+  expect_snapshot(path_package_pkgdown("x", "missing", 3), error = TRUE)
+})
diff --git a/vignettes/test/rendering.Rmd b/vignettes/test/rendering.Rmd
index 1317a5ba8..705b3da52 100644
--- a/vignettes/test/rendering.Rmd
+++ b/vignettes/test/rendering.Rmd
@@ -198,3 +198,9 @@ Guten tag.
 #### Heading 4
 
 ##### Heading 5
+
+## Very long words
+
+This word should be broken across multiple lines on mobile, rather than making the page scroll horizontally:
+
+Ccccccccccccaaaaaaaaaaaaaaatttttttttttttttttssssssssssssssss