From 4a285212a6421a437514caf1e9a99666b7443990 Mon Sep 17 00:00:00 2001 From: mpadge Date: Mon, 25 May 2026 11:12:32 +0200 Subject: [PATCH 01/11] review ai-updates text after feedback from @yabellini --- softwarereview_author.Rmd | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/softwarereview_author.Rmd b/softwarereview_author.Rmd index 5985965e4..7736c8b68 100644 --- a/softwarereview_author.Rmd +++ b/softwarereview_author.Rmd @@ -39,8 +39,10 @@ This concise guide presents the software peer review process for you as a packag The use of generative AI tools is acceptable in packages submitted for peer review, as described in [our initial blog post](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/). As stated in [our general policies](#policies-ai), we require all submitting authors to describe how such tools may have been used, and to include links to any relevant aspects of repositories. -A very general rule-of-thumb is the greater the use of generative AI tools in an rOpenSci submission, the more documentation we will expect, and the more we will expect such tools to have been used _systematically_. -Systematic tool usage includes any approach which transparently and progressively details the contribution of generative AI tools to software production. + +- Please provide easy-to-find details or links on any usage of generative AI tools in your documentation, like in [this package](https://apaf-bioinformatics.github.io/HydraR/#robot-use-of-generative-ai). +- A very general rule-of-thumb is the greater the use of generative AI tools in an rOpenSci submission, the more documentation we will expect, and the more we will expect such tools to have been used _systematically_. +- Systematic tool usage includes any approach which transparently and progressively details the contribution of generative AI tools to software production. Examples of systematic generative AI tools range from [GitHub's "spec-kit" for specification-driven development](https://github.com/github/spec-kit) to [our own experimental tool to document software design decisions](https://github.com/ropensci-review-tools/designlens). These all share the common pattern of producing additional artefacts which document the _process_ of development alongside the software itself. From c51263452e7dcae1678f7990ac5db277e3ad47c8 Mon Sep 17 00:00:00 2001 From: mark padgham Date: Fri, 29 May 2026 10:18:26 +0000 Subject: [PATCH 02/11] Apply suggestion from @mpadge --- softwarereview_author.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_author.Rmd b/softwarereview_author.Rmd index 7736c8b68..d86420793 100644 --- a/softwarereview_author.Rmd +++ b/softwarereview_author.Rmd @@ -42,7 +42,7 @@ As stated in [our general policies](#policies-ai), we require all submitting aut - Please provide easy-to-find details or links on any usage of generative AI tools in your documentation, like in [this package](https://apaf-bioinformatics.github.io/HydraR/#robot-use-of-generative-ai). - A very general rule-of-thumb is the greater the use of generative AI tools in an rOpenSci submission, the more documentation we will expect, and the more we will expect such tools to have been used _systematically_. -- Systematic tool usage includes any approach which transparently and progressively details the contribution of generative AI tools to software production. +- Systematic tool usage includes any approach which transparently and progressively details the contribution of generative AI tools to software production, such as [GitHub's "spec-kit"](https://github.github.com/spec-kit/). Examples of systematic generative AI tools range from [GitHub's "spec-kit" for specification-driven development](https://github.com/github/spec-kit) to [our own experimental tool to document software design decisions](https://github.com/ropensci-review-tools/designlens). These all share the common pattern of producing additional artefacts which document the _process_ of development alongside the software itself. From b566c5fd4879fb5cd4c0713c072ab73c45b451ba Mon Sep 17 00:00:00 2001 From: mpadge Date: Thu, 25 Jun 2026 14:33:22 +0200 Subject: [PATCH 03/11] rephrase points about 'systematic tool usage'; ping @maelle --- softwarereview_author.Rmd | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/softwarereview_author.Rmd b/softwarereview_author.Rmd index c4992eaae..0d3c09cfa 100644 --- a/softwarereview_author.Rmd +++ b/softwarereview_author.Rmd @@ -42,12 +42,16 @@ This concise guide presents the software peer review process for you as a packag The use of generative AI tools is acceptable in packages submitted for peer review, as described in [our initial blog post](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/). As stated in [our general policies](#policies-ai), we require all submitting authors to describe how such tools may have been used, and to include links to any relevant aspects of repositories. -- Please provide easy-to-find details or links on any usage of generative AI tools in your documentation, like in [this package](https://apaf-bioinformatics.github.io/HydraR/#robot-use-of-generative-ai). -- A very general rule-of-thumb is the greater the use of generative AI tools in an rOpenSci submission, the more documentation we will expect, and the more we will expect such tools to have been used _systematically_. -- Systematic tool usage includes any approach which transparently and progressively details the contribution of generative AI tools to software production, such as [GitHub's "spec-kit"](https://github.github.com/spec-kit/). +- Please provide easy-to-find details or links on any usage of generative AI tools in your documentation, like in [this package](https://apaf-bioinformatics.github.io/HydraR/#robot-use-of-generative-ai), which helpfully includes the following statements: + > For a detailed disclosure of AI usage, please refer to the [agents.md](https://apaf-bioinformatics.github.io/HydraR/agents.html) file. + > For architectural rationale and design tradeoffs, please refer to the [DESIGN.md](https://apaf-bioinformatics.github.io/HydraR/DESIGN.html) file. + Both files are linked to directly from the main README, and included within the repository itself. +- A very general rule-of-thumb is the greater the use of generative AI tools in an rOpenSci submission, the more we will expect tool use to be documented within the software itself. +- We request AI tools be used in systematic ways that record decisions guiding tool processes and outputs within the software itself. + - Systemtic tool usage contrasts with use through series of reactive prompts which commonly leave no trace within the software itself. Examples of systematic generative AI tools range from [GitHub's "spec-kit" for specification-driven development](https://github.com/github/spec-kit) to [our own experimental tool to document software design decisions](https://github.com/ropensci-review-tools/designlens). -These all share the common pattern of producing additional artefacts which document the _process_ of development alongside the software itself. +These all share the common pattern of producing additional artefacts which document decisions and processes of development alongside the software itself. #### How to use generative AI tools in preparing software for review From 5a6b33d62d7b3f3b71c912d7c5f7438b05d8d75b Mon Sep 17 00:00:00 2001 From: Yanina Bellini Saibene Date: Thu, 25 Jun 2026 15:27:27 -0300 Subject: [PATCH 04/11] Update pkg_building.es.Rmd --- pkg_building.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg_building.es.Rmd b/pkg_building.es.Rmd index 95314b2c3..e779e419e 100644 --- a/pkg_building.es.Rmd +++ b/pkg_building.es.Rmd @@ -304,7 +304,7 @@ Además, no se podrá hacer click en los enlaces desde la documentación local. ## Sitio web de documentación {#website} -Todos los paquetes enviados para su revisión de software deben incluir un enlace claro a la página web de documentación en el repositorio de código fuente. +Todos los paquetes enviados para su revisión deben incluir un enlace claro a la página web de documentación en el repositorio de código fuente. Te recomendamos que crees un sitio web con la documentación de tu paquete utilizando [`pkgdown`](https://github.com/r-lib/pkgdown). Hay un [capítulo sobre pkgdown (en inglés)](https://r-pkgs.org/website.html) en libro "R packages", y, cómo no es de extrañar, el paquete `pkgdown` tiene [su propio sitio web de documentación](https://pkgdown.r-lib.org/). From b145001f45a4076f76b096973e6cc897f97e8690 Mon Sep 17 00:00:00 2001 From: Yanina Bellini Saibene Date: Thu, 25 Jun 2026 15:27:42 -0300 Subject: [PATCH 05/11] Update softwarereview_author.es.Rmd --- softwarereview_author.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_author.es.Rmd b/softwarereview_author.es.Rmd index 45462c032..19f6e3268 100644 --- a/softwarereview_author.es.Rmd +++ b/softwarereview_author.es.Rmd @@ -17,7 +17,7 @@ Esta guía condensa el proceso de revisión por pares desde el punto de vista de - [Ejemplo de respuesta sobre solapamiento](https://github.com/ropensci/software-review/issues/199#issuecomment-375358362). Considera también añadir información sobre paquetes similares a tu [documentación de paquetes](#docs-general). - Los paquetes estadísticos deben cumplir los requisitos adicionales que se detallan en nuestra otra [*Guía de desarrollo de software estadístico*](https://stats-devguide.ropensci.org/). - - Software estadístico *debe* comenzar también con una investigación previa a la presentación. + - El software estadístico *debe* comenzar también con una consulta previa al envío para su revisión. ### Ciclo de desarrollo From 0c51a89e3fda9d6dca2c004107051199fdee3cba Mon Sep 17 00:00:00 2001 From: Yanina Bellini Saibene Date: Thu, 25 Jun 2026 15:28:00 -0300 Subject: [PATCH 06/11] Update softwarereview_editor.es.Rmd --- softwarereview_editor.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_editor.es.Rmd b/softwarereview_editor.es.Rmd index ffd171fd3..acaf6f64f 100644 --- a/softwarereview_editor.es.Rmd +++ b/softwarereview_editor.es.Rmd @@ -271,7 +271,7 @@ Cuando estas fuentes de información no sean suficientes, ##### Consejos para la búsqueda en Airtable {#tips-for-reviewer-search-in-airtable} -Nuestra base de datos de Airtable aparece enlazada en la parte superior de nuestro canal de Slack «*editors-only (solo equipo editorial)». +Nuestra base de datos de Airtable aparece enlazada en la parte superior de nuestro canal de Slack «*editors-only*» (solo equipo editorial). Una vez que inicies sesión en Airtable a través de ese enlace, deberías ver «*rOpenSci Software Review Database (Base de datos de reseñas de software de rOpenSci)*» con la opción «*Search Reviewers (buscar revisores)*» en la parte superior izquierda: ![Captura de pantalla de la interfaz de filtros de Airtable con un filtro sobre experiencia en disciplinas que debe incluir química y en conocimientos técnicos que tienen que incluir integración continua](images/airtable-filters.png) From 436a4be1492ecbee9b0832448ce8561c2bd5d6ee Mon Sep 17 00:00:00 2001 From: Yanina Bellini Saibene Date: Thu, 25 Jun 2026 15:28:12 -0300 Subject: [PATCH 07/11] Update softwarereview_editor.es.Rmd --- softwarereview_editor.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_editor.es.Rmd b/softwarereview_editor.es.Rmd index acaf6f64f..ff56bdce1 100644 --- a/softwarereview_editor.es.Rmd +++ b/softwarereview_editor.es.Rmd @@ -272,7 +272,7 @@ Cuando estas fuentes de información no sean suficientes, ##### Consejos para la búsqueda en Airtable {#tips-for-reviewer-search-in-airtable} Nuestra base de datos de Airtable aparece enlazada en la parte superior de nuestro canal de Slack «*editors-only*» (solo equipo editorial). -Una vez que inicies sesión en Airtable a través de ese enlace, deberías ver «*rOpenSci Software Review Database (Base de datos de reseñas de software de rOpenSci)*» con la opción «*Search Reviewers (buscar revisores)*» en la parte superior izquierda: +Una vez que inicies sesión en Airtable a través de ese enlace, deberías ver «*rOpenSci Software Review Database (Base de datos de revisiónes de software de rOpenSci)*» con la opción «*Search Reviewers*» (buscar personas revisores) en la parte superior izquierda: ![Captura de pantalla de la interfaz de filtros de Airtable con un filtro sobre experiencia en disciplinas que debe incluir química y en conocimientos técnicos que tienen que incluir integración continua](images/airtable-filters.png) From a0a71f6c27a70340b3c6145d99759c710defe49a Mon Sep 17 00:00:00 2001 From: Yanina Bellini Saibene Date: Thu, 25 Jun 2026 15:28:25 -0300 Subject: [PATCH 08/11] Update softwarereview_editor.es.Rmd --- softwarereview_editor.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_editor.es.Rmd b/softwarereview_editor.es.Rmd index ff56bdce1..89a10b39c 100644 --- a/softwarereview_editor.es.Rmd +++ b/softwarereview_editor.es.Rmd @@ -274,7 +274,7 @@ Cuando estas fuentes de información no sean suficientes, Nuestra base de datos de Airtable aparece enlazada en la parte superior de nuestro canal de Slack «*editors-only*» (solo equipo editorial). Una vez que inicies sesión en Airtable a través de ese enlace, deberías ver «*rOpenSci Software Review Database (Base de datos de revisiónes de software de rOpenSci)*» con la opción «*Search Reviewers*» (buscar personas revisores) en la parte superior izquierda: -![Captura de pantalla de la interfaz de filtros de Airtable con un filtro sobre experiencia en disciplinas que debe incluir química y en conocimientos técnicos que tienen que incluir integración continua](images/airtable-filters.png) +![Captura de pantalla de la interfaz de filtros de Airtable con un filtro sobre experiencia en disciplinas que debe incluir 'química' y en conocimientos técnicos que tienen que tener 'integración continua'](images/airtable-filters.png) Comprueba la revisión más reciente de la persona y evita a cualquiera que haya revisado en los últimos seis meses. Asimismo, comprueba si una persona que es nueva revisando ha indicado que requiere tutoría en el campo`require_mentorship`. From cdd75895cf6e3bd47691efda7df6673323807b04 Mon Sep 17 00:00:00 2001 From: Yanina Bellini Saibene Date: Thu, 25 Jun 2026 15:28:35 -0300 Subject: [PATCH 09/11] Update softwarereview_editor_management.es.Rmd --- softwarereview_editor_management.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_editor_management.es.Rmd b/softwarereview_editor_management.es.Rmd index 8caf422f0..ae9c8dec5 100644 --- a/softwarereview_editor_management.es.Rmd +++ b/softwarereview_editor_management.es.Rmd @@ -65,7 +65,7 @@ Te deseamos lo mejor, - Envíale una invitación a la base de datos de Airtable de revisión de software (enlazada en la descripción del canal sólo para editores en Slack). Asegúrate de que la invitación es "Sólo lectura". -- Actualiza el campo "editor" en la tabla "reviewers-prod" de Airtable (se utiliza para identificar y listar a las personas que son parte del equipo editorial actual dentro de esta *Guía de desarrollo*). +- Actualiza el campo "*editor*" en la tabla "*reviewers-prod*" de Airtable (se utiliza para identificar y listar a las personas que son parte del equipo editorial actual dentro de esta *Guía de desarrollo*). - Dale acceso al canal privado "editors-only" del espacio de trabajo Slack de rOpenSci (y al espacio de trabajo Slack en general si aún no están allí). - Una vez que esté en el canal "editors-only", envía un mensaje de bienvenida con un ping a todas las personas editoras. From c069a24a8a98bd4790217587d2d43b642ac8530d Mon Sep 17 00:00:00 2001 From: Yanina Bellini Saibene Date: Thu, 25 Jun 2026 15:28:45 -0300 Subject: [PATCH 10/11] Update softwarereview_editor_management.es.Rmd --- softwarereview_editor_management.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_editor_management.es.Rmd b/softwarereview_editor_management.es.Rmd index ae9c8dec5..226f90f0b 100644 --- a/softwarereview_editor_management.es.Rmd +++ b/softwarereview_editor_management.es.Rmd @@ -87,7 +87,7 @@ Te deseamos lo mejor, - Haz clic en el botón "_Share_ (compartir)" de la parte superior derecha, y luego en "_People with access_ (personas con acceso)" - Haz clic en la casilla de la izquierda de la persona que quieras remover y luego en "_Remove 1 collaborator_ (remover 1 colaborador/a)". -- Cambia su etiqueta "editor" a "Emérito", en los datos "reviewers-prod" de Airtable +- Cambia su etiqueta "*editor*" a "*Emérito*", en los datos "*reviewers-prod*" de Airtable - Las listas de integrantes del equipo editorial, tanto en el [capítulo de introducción a la revisión del software en la guía](https://github.com/ropensci/dev_guide/blob/main/softwarereview_intro.Rmd) como en el [README del repo de revisión de software](https://github.com/ropensci/software-review/blob/main/README.Rmd), se completan automáticamente a partir de los datos de AirTable. Las actualizaciones se ejecutan diariamente, así que compruébalo un día después de actualizar AirTable para asegurarte de que ambos se hayan actualizado. From 533a05713e55fbb8690e9b27ebf7f9c52dd8e6e8 Mon Sep 17 00:00:00 2001 From: Yanina Bellini Saibene Date: Thu, 25 Jun 2026 15:28:58 -0300 Subject: [PATCH 11/11] Update softwarereview_reviewer.es.Rmd --- softwarereview_reviewer.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_reviewer.es.Rmd b/softwarereview_reviewer.es.Rmd index 811715c6e..0777330e5 100644 --- a/softwarereview_reviewer.es.Rmd +++ b/softwarereview_reviewer.es.Rmd @@ -34,7 +34,7 @@ Todos los envíos generan un informe detallado sobre la estructura y funcionalid ### Directrices generales {#general-guidelines} -Para revisar un paquete, empieza por copiar nuestro [plantilla de revisión](#reviewtemplate) o la plantilla [plantilla de examen estadístico](https://stats-devguide.ropensci.org/pkgreview.html#pkgrev-template) para software estadístico. +Para revisar un paquete, empieza por copiar nuestra [plantilla de revisión](#reviewtemplate) o la [plantilla de revisión estadística](https://stats-devguide.ropensci.org/pkgreview.html#pkgrev-template) para software estadístico. Estas plantillas deben utilizarse como listas de comprobación de alto nivel para orientar la estructura de la revisión inicial. Además de marcar los criterios mínimos, te pedimos que aportes comentarios generales sobre lo siguiente: