add minimal mention of example datasets

booknews.Rmd

@@ -2,6 +2,8 @@
 
 ## dev version
 
+- 2025-07-11, add minimal mention of example datasets (#868).
+
 - 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_building.Rmd

@@ -256,6 +256,12 @@ f <- function(a = TRUE) {
 
 - Starting from roxygen2 version 7.0.0, `R6` classes are officially supported. See the [roxygen2 docs](https://roxygen2.r-lib.org/articles/rd-other.html#r6) for details on how to document `R6` classes.
 
+### Example datasets {#example-datasets}
+
+To document your package's interface, you might need to use example datasets.
+You can either use base R datasets (in the datasets package) such as penguins, or [re-distribute and document data](https://r-pkgs.org/data.html), with proper attributions.
+Be careful to choose data that comply with the [rOpenSci's code of conduct](https://ropensci.org/code-of-conduct/) and generally is not hurtful or alienating to anyone.
+
 ### URLs in documentation {#ur-ls-in-documentation}
 
 This subsection is particularly relevant to authors wishing to submit their package to CRAN.

pkg_building.es.Rmd

@@ -284,6 +284,12 @@ f <- function(a = TRUE) {
 - A partir de la versión 7.0.0 de roxygen2, las clases `R6` son oficialmente compatibles.
   Consulta la [documentación de roxygen2](https://roxygen2.r-lib.org/articles/rd-other.html#r6) para saber cómo documentar las clases `R6`.
 
+### Datos de ejemplo {#example-datasets}
+
+Para documentar la interfaz de su paquete, es posible que necesites utilizar datos de ejemplo.
+Puedes utilizar datos de R base (en el paquete datasets), como penguins, o [redistribuir y documentar datos](https://r-pkgs.org/data.html), con las atribuciones adecuadas.
+Ten cuidado de elegir datos que cumplan con el [código de conducta de rOpenSci](https://ropensci.org/code-of-conduct/) y que, en general, no sean perjudiciales ni alienantes para nadie.
+
 ### URLs en la documentación {#ur-ls-in-documentation}
 
 Esta subsección es especialmente relevante para quienes deseen enviar su paquete a CRAN.