document when pkgdown websites are re-built

booknews.Rmd

@@ -2,6 +2,8 @@
 
 ## dev version
 
+- 2025-07-11, document better when the pkgdown websites of rOpenSci packages are re-built (#919).
+
 - 2025-07-09, add a mention of ROR IDs (#909).
 
 - 2025-07-09, remove the upper-case from the NEWS.md template and update the real example link. (#896)

pkg_ci.Rmd

@@ -115,7 +115,15 @@ After transfer to rOpenSci's "ropensci" GitHub organization, each push to the re
 
 ## Even more CI: rOpenSci docs {#rodocsci}
 
-After transfer to rOpenSci's "ropensci" GitHub organization, a pkgdown website will be built for your package after each push to the GitHub repo. You can find the status of these builds at `https://ropensci.r-universe.dev/ui#packages` and in the [commit status](https://ropensci.org/blog/2021/09/03/runiverse-docs/#how-it-works). The website build will use your pkgdown config file if you have one, except for the styling that will use the [`rotemplate` package](https://github.com/ropensci-org/rotemplate/). 
+After transfer to rOpenSci's "ropensci" GitHub organization, a pkgdown website will be built for your package:
+
+- For each new commit to the default branch (checked approx once per hour).
+
+- When any of the strong dependencies in the same universe updates the version number.
+
+- Once per month.
+
+You can find the status of these builds at `https://ropensci.r-universe.dev/ui#packages` and in the [commit status](https://ropensci.org/blog/2021/09/03/runiverse-docs/#how-it-works). The website build will use your pkgdown config file if you have one, except for the styling that will use the [`rotemplate` package](https://github.com/ropensci-org/rotemplate/). 
 
 Please report bugs, questions and feature requests about the central builds and about the template at [https://github.com/ropensci-org/rotemplate/](https://github.com/ropensci-org/rotemplate/).