Skip to content

start policy updates on ai tool usage - #1006

Open
mpadge wants to merge 36 commits into
mainfrom
ai-updates
Open

start policy updates on ai tool usage#1006
mpadge wants to merge 36 commits into
mainfrom
ai-updates

Conversation

@mpadge

@mpadge mpadge commented Apr 20, 2026

Copy link
Copy Markdown
Member

Checklist for dev guide maintainers, do not delete 😸

  • Review of the content in the initial language.
  • News item.
  • Translation of the content in other languages.
  • Review of the translations.

@maelle

maelle commented May 18, 2026

Copy link
Copy Markdown
Member

Any ETA? We could aim for a small release that'd have this and the other changes since the last release. I know this is all still very WIP.

@mpadge

mpadge commented May 18, 2026

Copy link
Copy Markdown
Member Author

Any ETA? We could aim for a small release that'd have this and the other changes since the last release. I know this is all still very WIP.

Thanks for the prod - I think this should be merged as quickly as possible. I also think it's okay for an initial first draft of our policies. I hope and expect we'll edit and revise as things proceed, but am happy for you to tweak, approve, and merge when you're ready. Thanks!

@mpadge
mpadge requested a review from maelle May 18, 2026 14:11
@maelle

maelle commented May 21, 2026

Copy link
Copy Markdown
Member

I'll generate the translations ASAP.

@maelle
maelle force-pushed the ai-updates branch 4 times, most recently from c191b55 to 7220acd Compare May 21, 2026 14:11
@maelle
maelle requested review from a team as code owners May 22, 2026 07:48
@maelle
maelle requested review from beatrizmilz and yabellini and removed request for a team May 22, 2026 07:48
@maelle
maelle requested review from fblpalmeira and removed request for beatrizmilz May 22, 2026 11:48
@mpadge

mpadge commented May 22, 2026

Copy link
Copy Markdown
Member Author

@maelle I also just added another checkbox to templates/review.md which will also need translating.

@maelle

maelle commented May 22, 2026

Copy link
Copy Markdown
Member

@mpadge I added the missing translations. In such cases I use copy-paste (DeepL interface or https://docs.ropensci.org/babeldown/reference/deepl_translate_clipboard.html), I can only use deepl_branch_update() when no translation has been added yet.

@yabellini yabellini left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some Spanish suggestions.
Some comments on the clarity of the instructions.
There is text that is repeated twice; it looks like we should delete one.

Comment thread softwarereview_author.es.Rmd Outdated
Comment thread softwarereview_author.es.Rmd Outdated
Comment thread softwarereview_author.es.Rmd Outdated
Comment thread softwarereview_author.es.Rmd Outdated
Comment thread softwarereview_policies.es.Rmd Outdated
Comment thread softwarereview_reviewer.es.Rmd Outdated
Comment thread softwarereview_reviewer.es.Rmd Outdated
Comment thread softwarereview_reviewer.es.Rmd Outdated
Comment thread softwarereview_reviewer.pt.Rmd Outdated
Comment thread softwarereview_reviewer.Rmd Outdated
Co-authored-by: Yanina Bellini Saibene <yabellini@gmail.com>
Co-authored-by: Maëlle Salmon <maelle.salmon@yahoo.se>
Comment thread softwarereview_reviewer.Rmd Outdated
@maelle

maelle commented Sep 7, 2026

Copy link
Copy Markdown
Member

I've made two last edit suggestions. Once @yabellini also approves the English content, I'll generate the translations 🎉 I'm very happy with the end result, well done us 😸

mpadge and others added 2 commits September 8, 2026 07:40
Co-authored-by: Maëlle Salmon <maelle.salmon@yahoo.se>

@yabellini yabellini left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. I leave a comment with some fix to the Spanish template.
And also a comment about where the reviewer have to add the details on how they use AI for the review. It is in the comments on the issue?

@mpadge

mpadge commented Sep 10, 2026

Copy link
Copy Markdown
Member Author

Thanks @yabellini 😄

Looks good. I leave a comment with some fix to the Spanish template. And also a comment about where the reviewer have to add the details on how they use AI for the review. It is in the comments on the issue?

The PR also includes this addition to reviewer templates:

#### Use of generative AI tools


- [ ] Generative AI tools were used to assist this reviewExpand commentComment on line R39Resolved

Only if you tick that box: Explain the contribution of such tools to your review.

So yes, that will be pasted into the review itself. Does that answer your question?

@yabellini

Copy link
Copy Markdown
Member

Yes @mpadge , thank you!

@maelle

maelle commented Sep 10, 2026

Copy link
Copy Markdown
Member

@mpadge in the future please do not merge main into a PR branch, that makes deepl_branch_update() impossible to use 😁

@github-actions
github-actions Bot temporarily deployed to pull request September 11, 2026 06:37 Inactive
@maelle

maelle commented Sep 11, 2026

Copy link
Copy Markdown
Member

Fixed the build by re-starting it twice 🤷‍♀️

@mpadge

mpadge commented Sep 11, 2026

Copy link
Copy Markdown
Member Author

@mpadge in the future please do not merge main into a PR branch, that makes deepl_branch_update() impossible to use 😁

Sorry about that 😭 I thought I was being helpful ... shan't do that again 😆

Comment thread pkg_building.es.Rmd
Puede que el paquete [gert](https://docs.ropensci.org/gert/) te resulte útil, así como algunas de las [funciones de usethis relacionadas con Git/GitHub](https://usethis.r-lib.org/reference/index.html#section-git-and-github); sin embargo, puedes utilizar git como quieras.


- Las confirmaciones de Git breves e informativas permiten comprender y depurar mejor un proyecto. No agrupes demasiados cambios no relacionados en una sola confirmación; evita usar mensajes de confirmación sin sentido, como «actualización» o «confirmación». No exigimos un historial de Git impecable, pero recomendamos encarecidamente que te esfuerces por lograrlo. Recursos útiles:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Las confirmaciones de Git breves e informativas permiten comprender y depurar mejor un proyecto. No agrupes demasiados cambios no relacionados en una sola confirmación; evita usar mensajes de confirmación sin sentido, como «actualización» o «confirmación». No exigimos un historial de Git impecable, pero recomendamos encarecidamente que te esfuerces por lograrlo. Recursos útiles:
- Los _commits_ de Git breves e informativos permiten comprender y depurar mejor un proyecto. No agrupes demasiados cambios no relacionados en un solo _commit_, evita usar mensajes sin sentido en tus _commits_, como «actualización» o «confirmación». No exigimos un historial de Git impecable, pero recomendamos encarecidamente que te esfuerces por lograrlo. Recursos útiles:

Comment thread pkg_building.es.Rmd


- Las confirmaciones de Git breves e informativas permiten comprender y depurar mejor un proyecto. No agrupes demasiados cambios no relacionados en una sola confirmación; evita usar mensajes de confirmación sin sentido, como «actualización» o «confirmación». No exigimos un historial de Git impecable, pero recomendamos encarecidamente que te esfuerces por lograrlo. Recursos útiles:
- ["Escribe mejores confirmaciones, crea mejores proyectos"](https://github.blog/developer-skills/github/write-better-commits-build-better-projects/);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- ["Escribe mejores confirmaciones, crea mejores proyectos"](https://github.blog/developer-skills/github/write-better-commits-build-better-projects/);
- ["Escribe mejores _commits_, crea mejores proyectos"](https://github.blog/developer-skills/github/write-better-commits-build-better-projects/);

Comment thread pkg_building.es.Rmd

- Las confirmaciones de Git breves e informativas permiten comprender y depurar mejor un proyecto. No agrupes demasiados cambios no relacionados en una sola confirmación; evita usar mensajes de confirmación sin sentido, como «actualización» o «confirmación». No exigimos un historial de Git impecable, pero recomendamos encarecidamente que te esfuerces por lograrlo. Recursos útiles:
- ["Escribe mejores confirmaciones, crea mejores proyectos"](https://github.blog/developer-skills/github/write-better-commits-build-better-projects/);
- ["Por qué necesitas confirmaciones de Git pequeñas e informativas"](https://masalmon.eu/2024/06/03/small-commits/);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- ["Por qué necesitas confirmaciones de Git pequeñas e informativas"](https://masalmon.eu/2024/06/03/small-commits/);
- ["Por qué necesitas _commits_ pequeños e informativos"](https://masalmon.eu/2024/06/03/small-commits/);

### Uso de herramientas de IA generativa

- El uso de herramientas de IA generativa es aceptable en los paquetes enviados para revisión por pares, tal como se describe en [nuestra publicación inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/).
- Tal como se indica en [nuestras políticas generales](#policies-ai), exigimos a todos los autores que envíen trabajos que proporcionen detalles sobre cualquier uso de herramientas de IA generativa en la documentación del paquete, generalmente en los archivos README o en las guías de contribución.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Tal como se indica en [nuestras políticas generales](#policies-ai), exigimos a todos los autores que envíen trabajos que proporcionen detalles sobre cualquier uso de herramientas de IA generativa en la documentación del paquete, generalmente en los archivos README o en las guías de contribución.
- Tal como se indica en [nuestras políticas generales](#policies-ai), exigimos a todas las personas que envíen trabajos que proporcionen detalles sobre cualquier uso de herramientas de IA generativa. Esperamos que para ello usen la documentación del paquete, generalmente en los archivos README o en las guías de contribución.

- El uso de herramientas de IA generativa es aceptable en los paquetes enviados para revisión por pares, tal como se describe en [nuestra publicación inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/).
- Tal como se indica en [nuestras políticas generales](#policies-ai), exigimos a todos los autores que envíen trabajos que proporcionen detalles sobre cualquier uso de herramientas de IA generativa en la documentación del paquete, generalmente en los archivos README o en las guías de contribución.
- Las descripciones detalladas sobre el uso de herramientas de IA o las decisiones de diseño también pueden incluirse en documentos separados; en ese caso, deben enlazarse directamente desde el archivo README o la guía de contribución.
- Un ejemplo es [el paquete `HydraR`](https://apaf-bioinformatics.github.io/HydraR/# uso-de-ia-generativa-por-robots), que incluye un enlace en el archivo README principal a los archivos [agents.md](https://apaf-bioinformatics.github.io/HydraR/agents.html) y [DESIGN.md](https://apaf-bioinformatics.github.io/HydraR/DESIGN.html).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Un ejemplo es [el paquete `HydraR`](https://apaf-bioinformatics.github.io/HydraR/# uso-de-ia-generativa-por-robots), que incluye un enlace en el archivo README principal a los archivos [agents.md](https://apaf-bioinformatics.github.io/HydraR/agents.html) y [DESIGN.md](https://apaf-bioinformatics.github.io/HydraR/DESIGN.html).
- Un ejemplo es [el paquete `HydraR`](https://apaf-bioinformatics.github.io/HydraR/#uso-de-ia-generativa-por-robots), que incluye un enlace en el archivo README principal a los archivos [agents.md](https://apaf-bioinformatics.github.io/HydraR/agents.html) y [DESIGN.md](https://apaf-bioinformatics.github.io/HydraR/DESIGN.html).

- Un ejemplo es [el paquete `HydraR`](https://apaf-bioinformatics.github.io/HydraR/# uso-de-ia-generativa-por-robots), que incluye un enlace en el archivo README principal a los archivos [agents.md](https://apaf-bioinformatics.github.io/HydraR/agents.html) y [DESIGN.md](https://apaf-bioinformatics.github.io/HydraR/DESIGN.html).
- Una regla general muy básica es que, cuanto mayor sea el uso de herramientas de IA generativa en un paquete, más esperaremos que el uso de dichas herramientas esté documentado dentro del propio software.
- Sugerimos utilizar las herramientas de IA de manera que se registren las decisiones que guían los procesos de desarrollo y los resultados dentro del propio software.
- Entre los ejemplos de este tipo de herramientas se encuentran desde [el «spec-kit» de GitHub para el desarrollo basado en especificaciones](https://github.com/github/spec-kit) hasta [nuestra propia herramienta experimental para documentar las decisiones de diseño de software](https://github.com/ropensci-review-tools/designlens).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Entre los ejemplos de este tipo de herramientas se encuentran desde [el «spec-kit» de GitHub para el desarrollo basado en especificaciones](https://github.com/github/spec-kit) hasta [nuestra propia herramienta experimental para documentar las decisiones de diseño de software](https://github.com/ropensci-review-tools/designlens).
- Entre los ejemplos de este tipo de herramientas se encuentran [el «spec-kit» de GitHub para el desarrollo basado en especificaciones](https://github.com/github/spec-kit) y [nuestra propia herramienta experimental para documentar las decisiones de diseño de software](https://github.com/ropensci-review-tools/designlens).

- Una regla general muy básica es que, cuanto mayor sea el uso de herramientas de IA generativa en un paquete, más esperaremos que el uso de dichas herramientas esté documentado dentro del propio software.
- Sugerimos utilizar las herramientas de IA de manera que se registren las decisiones que guían los procesos de desarrollo y los resultados dentro del propio software.
- Entre los ejemplos de este tipo de herramientas se encuentran desde [el «spec-kit» de GitHub para el desarrollo basado en especificaciones](https://github.com/github/spec-kit) hasta [nuestra propia herramienta experimental para documentar las decisiones de diseño de software](https://github.com/ropensci-review-tools/designlens).
- Todas ellas comparten el patrón común de generar artefactos adicionales que documentan las decisiones y los procesos de desarrollo junto con el software en sí.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Todas ellas comparten el patrón común de generar artefactos adicionales que documentan las decisiones y los procesos de desarrollo junto con el software en sí.
- Estas herramientas comparten el patrón común de generar artefactos adicionales que documentan las decisiones y los procesos de desarrollo junto con el software en sí.


## Uso de herramientas de IA generativa {#policies-ai}

Los autores deben declarar cualquier uso de herramientas de IA generativa en nuestros formularios de envío, donde también les pedimos que:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Los autores deben declarar cualquier uso de herramientas de IA generativa en nuestros formularios de envío, donde también les pedimos que:
Las personas responsables del paquete deben declarar cualquier uso de herramientas de IA generativa en nuestro formulario de envío, donde también les pedimos que:


Los autores deben declarar cualquier uso de herramientas de IA generativa en nuestros formularios de envío, donde también les pedimos que:

> describan el uso e incluyan enlaces a cualquier aspecto relevante de su repositorio.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> describan el uso e incluyan enlaces a cualquier aspecto relevante de su repositorio.
> describan el uso de IA generativa e incluyan enlaces a cualquier aspecto relevante de su repositorio.


> describan el uso e incluyan enlaces a cualquier aspecto relevante de su repositorio.

Tal como se describe en [nuestra publicación inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/), se espera que nuestras políticas sobre el uso de herramientas de IA generativa evolucionen a la par del desarrollo de las propias herramientas, así como de la forma en que estas contribuyen al desarrollo de software.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Tal como se describe en [nuestra publicación inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/), se espera que nuestras políticas sobre el uso de herramientas de IA generativa evolucionen a la par del desarrollo de las propias herramientas, así como de la forma en que estas contribuyen al desarrollo de software.
Tal como se describe en [nuestra publicación inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/), esperamos que nuestras políticas sobre el uso de herramientas de IA generativa evolucionen a la par del desarrollo de las propias herramientas, así como de la forma en que estas contribuyen al desarrollo de software.

> describan el uso e incluyan enlaces a cualquier aspecto relevante de su repositorio.

Tal como se describe en [nuestra publicación inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/), se espera que nuestras políticas sobre el uso de herramientas de IA generativa evolucionen a la par del desarrollo de las propias herramientas, así como de la forma en que estas contribuyen al desarrollo de software.
Esperamos que todos los autores que envíen trabajos revelen de manera transparente cómo las herramientas de IA generativa pueden haber contribuido a cualquier software enviado para revisión por pares.

@yabellini yabellini Sep 11, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Esperamos que todos los autores que envíen trabajos revelen de manera transparente cómo las herramientas de IA generativa pueden haber contribuido a cualquier software enviado para revisión por pares.
Esperamos que todas las personas que envíen paquetes a nuestra revisión de software por pares revelen de manera transparente cómo las herramientas de IA generativa contribuyeron al desarrollo de su paquete.


Tal como se describe en [nuestra publicación inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/), se espera que nuestras políticas sobre el uso de herramientas de IA generativa evolucionen a la par del desarrollo de las propias herramientas, así como de la forma en que estas contribuyen al desarrollo de software.
Esperamos que todos los autores que envíen trabajos revelen de manera transparente cómo las herramientas de IA generativa pueden haber contribuido a cualquier software enviado para revisión por pares.
Los detalles se proporcionan tanto en la [_Guía para autores_](#authors-guide) como en la [_Guía para revisores_](#reviewerguide).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Los detalles se proporcionan tanto en la [_Guía para autores_](#authors-guide) como en la [_Guía para revisores_](#reviewerguide).
Los detalles para describir el uso de IA generativa se proporcionan tanto en la [_Guía para autores_](#authors-guide) como en la [_Guía para revisores_](#reviewerguide).

### Uso de herramientas de IA generativa


El uso de herramientas de IA generativa es aceptable tanto para los autores que envían sus trabajos como para los revisores; sin embargo, los revisores no pueden utilizar estas herramientas para fundamentar ninguna decisión o recomendación sin supervisión humana.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
El uso de herramientas de IA generativa es aceptable tanto para los autores que envían sus trabajos como para los revisores; sin embargo, los revisores no pueden utilizar estas herramientas para fundamentar ninguna decisión o recomendación sin supervisión humana.
El uso de herramientas de IA generativa es aceptable tanto para las personas que envían sus paquetes como para las personas que revisan; sin embargo, los integrantes del equipo revisor no pueden utilizar estas herramientas para fundamentar ninguna decisión o recomendación sin supervisión humana.


El uso de herramientas de IA generativa es aceptable tanto para los autores que envían sus trabajos como para los revisores; sin embargo, los revisores no pueden utilizar estas herramientas para fundamentar ninguna decisión o recomendación sin supervisión humana.

Al igual que con nuestras expectativas para los autores, exigimos a los revisores que revelen cualquier uso de herramientas de IA generativa con el mayor detalle posible.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Al igual que con nuestras expectativas para los autores, exigimos a los revisores que revelen cualquier uso de herramientas de IA generativa con el mayor detalle posible.
Al igual que con nuestras expectativas para las personas autoras, exigimos a quienes revisan que revelen cualquier uso de herramientas de IA generativa con el mayor detalle posible.


Al igual que con nuestras expectativas para los autores, exigimos a los revisores que revelen cualquier uso de herramientas de IA generativa con el mayor detalle posible.
Algunos ejemplos de uso aceptable incluyen la generación de una descripción general de la funcionalidad del paquete o el análisis del historial de Git para ofrecer una visión general de las decisiones de desarrollo.
Pedimos a los revisores que sean lo más transparentes posible.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Pedimos a los revisores que sean lo más transparentes posible.
Pedimos a quienes revisan que sean lo más transparentes posible.

@yabellini yabellini left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I reviewed and suggested changes to the Spanish version. Mostly gender marks and some wording to make it clearer

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants