diff --git a/appendix.Rmd b/appendix.Rmd
index d6d2d6129..40f07cd47 100644
--- a/appendix.Rmd
+++ b/appendix.Rmd
@@ -4,6 +4,8 @@
 
 ## dev
 
+- 2021-11-18, update advice on grouping functions for pkgdown output (#361)
+
 * 2021-11-04, add mentions of stat software review to software review intro and to the first book page (#342).
 
 * 2021-11-04, mention pkgcheck in the author guide (@mpadge, #343).
diff --git a/pkg_building.Rmd b/pkg_building.Rmd
index 79f2b0921..3caccec16 100644
--- a/pkg_building.Rmd
+++ b/pkg_building.Rmd
@@ -205,7 +205,7 @@ can be found at *link*".
 
 * All functions should document the type of object returned under the `@return` heading.
 
-* We recommend using the `@family` tag in the documentation of functions to allow their grouping in the documentation of the installed package and potentially in the package's website, see [the "manual" section of The R Packages book](https://r-pkgs.org/man.html) and [the "function grouping" section of the present chapter](#function-grouping) for more details.
+- Documentation should support user navigation by including useful cross-links between related functions and documenting related functions together in groups or in common help pages.  The @seealso and @family tags (the latter of which automatically creates “See also” links and [can help group](https://pkgdown.r-lib.org/reference/build_reference.html) functions together on pkgdown sites), are recommended for this purpose. See [the "manual" section of The R Packages book](https://r-pkgs.org/man.html) and [the "function grouping" section of the present chapter](#function-grouping) for more details.
 
 * You could re-use documentation pieces (e.g. details about authentication, related packages) across the vignettes/README/man pages. A possible approach for that is the use of [R Markdown fragments, relying on knitr use of child documents so you can store the re-used parts in a folder in man/, and call them from both the README and the vignette](https://www.garrickadenbuie.com/blog/dry-vignette-and-readme/) as well [as in man pages by using the `@includeRmd` tag available from `roxygen 0.7.0`](https://roxygen2.r-lib.org/articles/rd.html#including-external--rmd-md-files).