add how to deprecate data (#894)

* add how to deprecate data

* news item

* Update maintenance_evolution.es.Rmd

Co-authored-by: Yanina Bellini Saibene <[email protected]>

* Update maintenance_evolution.es.Rmd

* add change to the right place

* Update maintenance_evolution.pt.Rmd

Co-authored-by: Beatriz Milz <[email protected]>

---------

Co-authored-by: Yanina Bellini Saibene <[email protected]>
Co-authored-by: Beatriz Milz <[email protected]>

Author: 3 people

booknews.Rmd

@@ -2,6 +2,8 @@
 
 ## dev version
 
+- 2025-03-13, add a note on how to deprecate *data* (#649)
+
 - 2025-04-10, add link to pkgcheck vignette on our testing environment (#589)
 
 - 2025-04-10, replace the link to the Mozilla Code Review guide with explicit items (#835)

maintenance_evolution.Rmd

@@ -104,6 +104,12 @@ After users have used the package version for a while (with both `foo` and `bar`
 bar <- function(x) x + 1
 ```
 
+## Data: deprecate
+
+If you need to deprecate a dataset provided by your package, 
+read the [solution proposed by Matthijs Berends on Stack Overflow](https://stackoverflow.com/questions/33304651/data-deprecation-in-r-package/75192818#75192818), linking to [a 3-step method in Bioconductor guidance](https://contributions.bioconductor.org/deprecation.html#deprecate-dataset).
+Key is the usage of [`delayedAssign()`](https://stat.ethz.ch/R-manual/R-patched/library/base/html/delayedAssign.html) to save a promise that will serve both a warning, and the data.
+
 ## Functions: deprecate \& defunct {#functions-deprecate-defunct}
 
 To remove a function from a package (let's say your package name is `helloworld`), you can use the following protocol:

maintenance_evolution.es.Rmd

@@ -207,6 +207,12 @@ No es necesario que cambies los test de las funciones obsoletas hasta que caduqu
 
 Una vez que se caduca una función, sus tests se eliminan sin más.
 
+## Datos: obsoletos
+
+Si necesita eliminar un conjunto de datos proporcionado por tu paquete, 
+lee la [solución propuesta por Matthijs Berends en Stack Overflow](https://stackoverflow.com/questions/33304651/data-deprecation-in-r-package/75192818#75192818), que enlaza con [un método de 3 pasos en la guía de Bioconductor](https://contributions.bioconductor.org/deprecation.html#deprecate-dataset).
+La clave es el uso de [`delayedAssign()`](https://stat.ethz.ch/R-manual/R-patched/library/base/html/delayedAssign.html) para guardar una promesa que servirá tanto de aviso, como para poder disponible los datos.
+
 ## Archivando paquetes  {#archivalguidance}
 
 Por lo general, el software tiene una vida útil finita, y es posible que los paquetes deban ser archivados en algún momento.

maintenance_evolution.pt.Rmd

@@ -104,6 +104,11 @@ Depois que os usuários tiverem usado a versão do pacote por algum tempo (com a
 bar <- function(x) x + 1
 ```
 
+## Dados: descontinuar
+
+Se você precisar descontinuar (*deprecate*) um conjunto de dados fornecido pelo seu pacote, 
+leia a [solução proposta por Matthijs Berends no Stack Overflow](https://stackoverflow.com/questions/33304651/data-deprecation-in-r-package/75192818#75192818), com link para [um método de três etapas na orientação do Bioconductor] (https://contributions.bioconductor.org/deprecation.html#deprecate-dataset).
+O ponto principal é o uso de [`delayedAssign()`](https://stat.ethz.ch/R-manual/R-patched/library/base/html/delayedAssign.html) para criar uma *promise* que servirá tanto para emitir um aviso (*warning*) quanto para fornecer os dados.
 ## Funções: descontinuadas e removidas {#functions-deprecate-defunct}
 
 Para remover uma função de um pacote (digamos que o nome do seu pacote seja `helloworld`), você pode usar o seguinte protocolo: