start policy updates on ai tool usage by mpadge · Pull Request #1006 · ropensci/dev_guide

mpadge · 2026-04-20T10:15:06Z

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 · 2026-05-18T13:38:15Z

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 · 2026-05-18T14:11:33Z

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!

maelle · 2026-05-21T07:12:47Z

I'll generate the translations ASAP.

mpadge · 2026-05-22T12:40:19Z

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

maelle · 2026-05-22T13:33:08Z

@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

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.

yabellini · 2026-05-22T14:23:27Z


+### Uso de herramientas de IA generativa
+
+El uso de herramientas de IA generativa es aceptable en los paquetes enviados para revisión por pares, como se describe en [nuestra entrada inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/).


Suggested change

El uso de herramientas de IA generativa es aceptable en los paquetes enviados para revisión por pares, como se describe en [nuestra entrada inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/).

El uso de herramientas de IA generativa es aceptable en los paquetes enviados para revisión por pares, como se describe en [nuestro artículo en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/).

yabellini · 2026-05-22T14:25:54Z

+### Uso de herramientas de IA generativa
+
+El uso de herramientas de IA generativa es aceptable en los paquetes enviados para revisión por pares, como se describe en [nuestra entrada inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/).
+Como se indica en [nuestras políticas generales](#policies-ai) exigimos a todos los autores que envíen propuestas que describan cómo se han utilizado dichas herramientas, y que incluyan enlaces a cualquier aspecto relevante de los repositorios.


Suggested change

Como se indica en [nuestras políticas generales](#policies-ai) exigimos a todos los autores que envíen propuestas que describan cómo se han utilizado dichas herramientas, y que incluyan enlaces a cualquier aspecto relevante de los repositorios.

Como se indica en [nuestras políticas generales](#policies-ai) exigimos a todas las personas autoras que envíen propuestas que describan cómo se han utilizado dichas herramientas, y que incluyan enlaces a cualquier aspecto relevante de los repositorios.

yabellini · 2026-05-22T14:52:19Z

+
+El uso de herramientas de IA generativa es aceptable en los paquetes enviados para revisión por pares, como se describe en [nuestra entrada inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/).
+Como se indica en [nuestras políticas generales](#policies-ai) exigimos a todos los autores que envíen propuestas que describan cómo se han utilizado dichas herramientas, y que incluyan enlaces a cualquier aspecto relevante de los repositorios.
+Una regla muy general es que cuanto mayor sea el uso de herramientas de IA generativa en un envío a rOpenSci, más documentación esperaremos y más esperaremos que se hayan utilizado dichas herramientas. *sistemáticamente*.


Suggested change

Una regla muy general es que cuanto mayor sea el uso de herramientas de IA generativa en un envío a rOpenSci, más documentación esperaremos y más esperaremos que se hayan utilizado dichas herramientas. *sistemáticamente*.

Una regla general es que, cuanto más se utilicen herramientas de IA generativa en en un paquete enviado a rOpenSci, más documentación esperaremos recibir. Además esperaremos que dichas herramientas se hayan utilizado *sistemáticamente*.

yabellini · 2026-05-22T15:00:54Z

+Como se indica en [nuestras políticas generales](#policies-ai) exigimos a todos los autores que envíen propuestas que describan cómo se han utilizado dichas herramientas, y que incluyan enlaces a cualquier aspecto relevante de los repositorios.
+Una regla muy general es que cuanto mayor sea el uso de herramientas de IA generativa en un envío a rOpenSci, más documentación esperaremos y más esperaremos que se hayan utilizado dichas herramientas. *sistemáticamente*.
+El uso sistemático de herramientas incluye cualquier enfoque que detalle de forma transparente y progresiva la contribución de las herramientas de IA generativa a la producción de software.
+Los ejemplos de herramientas sistemáticas de IA generativa van desde [el "spec-kit" de GitHub para el desarrollo basado en especificaciones](https://github.com/github/spec-kit) a [nuestra propia herramienta experimental para documentar las decisiones de diseño de software](https://github.com/ropensci-review-tools/designlens).


I have some problems understanding what I'm supposed to do if I use AI in my package to meet the requirements outlined here. I need to check the examples linked in more deeply. I'm wondering if we can link to good examples from a package under review or other packages that have the information as we would like to see.

yabellini · 2026-05-22T15:05:29Z


+## Uso de herramientas de IA generativa {#policies-ai\]}
+
+Los autores deben revelar cualquier uso de herramientas de IA generativa en nuestros formularios de envío, donde también te pedimos que lo hagas,


Suggested change

Los autores deben revelar cualquier uso de herramientas de IA generativa en nuestros formularios de envío, donde también te pedimos que lo hagas,

Las personas autoras del paquete deben informar cualquier uso de herramientas de IA generativa en su paquete, en el momento que realizan el envío. También te pedimos que lo hagas,

yabellini · 2026-05-22T16:49:32Z

+
+El uso de herramientas de IA generativa es aceptable tanto para los autores como para los revisores, pero los revisores no pueden utilizarlas para fundamentar directamente sus decisiones o recomendaciones.
+Por lo general, los revisores deben solicitar la aprobación de los autores y editores antes de utilizar herramientas de IA generativa, y hacerlo públicamente en el hilo de la revisión.
+Al igual que esperamos de los autores, exigimos a los revisores que revelen cualquier uso de herramientas de IA generativa con el mayor detalle posible.


Suggested change

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

De la misma manera que les solicitamos a las personas autoras de los paquetes, pedimos a las personas que revisan, que informen cualquier uso de herramientas de IA generativa con el mayor detalle posible.

yabellini · 2026-05-22T16:49:59Z

+Por lo general, los revisores deben solicitar la aprobación de los autores y editores antes de utilizar herramientas de IA generativa, y hacerlo públicamente en el hilo de la revisión.
+Al igual que esperamos de 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 son la generación de una visión general de la funcionalidad del paquete, o la iteración a través de un historial Git para proporcionar una visión general de las decisiones de desarrollo.
+Pedimos a los revisores que sean lo más transparentes posible.


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 · 2026-05-22T16:50:27Z

+El uso de herramientas de IA generativa es aceptable tanto para los autores como para los revisores, pero los revisores no pueden utilizarlas para fundamentar directamente sus decisiones o recomendaciones.
+Por lo general, los revisores deben solicitar la aprobación de los autores y editores antes de utilizar herramientas de IA generativa, y hacerlo públicamente en el hilo de la revisión.
+Al igual que esperamos de 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 son la generación de una visión general de la funcionalidad del paquete, o la iteración a través de un historial Git para proporcionar una visión general de las decisiones de desarrollo.


Can we link to some good examples? Or how can you actually do that?

yabellini · 2026-05-22T16:51:10Z

+Exemplos de uso aceitável incluem a geração de uma visão geral da funcionalidade do pacote ou a iteração em um histórico do Git para fornecer uma visão geral das decisões de desenvolvimento.
+Pedimos aos revisores que sejam o mais transparentes possível.
+
+### Uso de ferramentas de IA generativas


All this text looks like is repeated. I removed the second title and text in the Spanish version.

yabellini · 2026-05-22T16:51:58Z

+Examples of acceptable usage include generating an overview of package functionality, or iterating through a Git history to provide an overview of development decisions.
+We ask reviewers to be as transparent as possible.
+
+### Use of generative AI tools


This looks like it is repeated. It is the same text two times.
I removed it in the Spanish version. I advice to remove in the Portuguese one, I also suggest to remove from here.

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

maelle force-pushed the ai-updates branch 4 times, most recently from c191b55 to 7220acd Compare May 21, 2026 14:11

mpadge added 2 commits May 22, 2026 09:37

start policy updates on ai tool usage

ee99798

add suggestion for reviewers to ask approval for ai tool usage

c1a156e

maelle force-pushed the ai-updates branch from 7220acd to c1a156e Compare May 22, 2026 07:37

mpadge and others added 3 commits May 22, 2026 09:47

start policy updates on ai tool usage

63bd811

add suggestion for reviewers to ask approval for ai tool usage

408eff0

babeldown::deepl_branch_update()

45a08f1

maelle requested review from a team as code owners May 22, 2026 07:48

maelle requested review from beatrizmilz and yabellini and removed request for a team May 22, 2026 07:48

news item

8986330

maelle added the needs-translation-review label May 22, 2026

maelle requested review from fblpalmeira and removed request for beatrizmilz May 22, 2026 11:48

also add an 'ai' checkbox on reviewer template

0d78e12

add translations

3c9df0d

yabellini requested changes May 22, 2026

View reviewed changes


		### Uso de herramientas de IA generativa

		El uso de herramientas de IA generativa es aceptable en los paquetes enviados para revisión por pares, como se describe en [nuestra entrada inicial en el blog](https://ropensci.org/blog/2026/02/26/ropensci-ai-policy/).

	Como se indica en [nuestras políticas generales](#policies-ai) exigimos a todos los autores que envíen propuestas que describan cómo se han utilizado dichas herramientas, y que incluyan enlaces a cualquier aspecto relevante de los repositorios.
	Como se indica en [nuestras políticas generales](#policies-ai) exigimos a todas las personas autoras que envíen propuestas que describan cómo se han utilizado dichas herramientas, y que incluyan enlaces a cualquier aspecto relevante de los repositorios.

	Una regla muy general es que cuanto mayor sea el uso de herramientas de IA generativa en un envío a rOpenSci, más documentación esperaremos y más esperaremos que se hayan utilizado dichas herramientas. sistemáticamente.
	Una regla general es que, cuanto más se utilicen herramientas de IA generativa en en un paquete enviado a rOpenSci, más documentación esperaremos recibir. Además esperaremos que dichas herramientas se hayan utilizado sistemáticamente.


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

		Los autores deben revelar cualquier uso de herramientas de IA generativa en nuestros formularios de envío, donde también te pedimos que lo hagas,

	Los autores deben revelar cualquier uso de herramientas de IA generativa en nuestros formularios de envío, donde también te pedimos que lo hagas,
	Las personas autoras del paquete deben informar cualquier uso de herramientas de IA generativa en su paquete, en el momento que realizan el envío. También te pedimos que lo hagas,

	Al igual que esperamos de los autores, exigimos a los revisores que revelen cualquier uso de herramientas de IA generativa con el mayor detalle posible.
	De la misma manera que les solicitamos a las personas autoras de los paquetes, pedimos a las personas que revisan, que informen cualquier uso de herramientas de IA generativa con el mayor detalle posible.

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

Conversation

mpadge commented Apr 20, 2026 • edited by maelle Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

maelle commented May 18, 2026

Uh oh!

mpadge commented May 18, 2026

Uh oh!

maelle commented May 21, 2026

Uh oh!

mpadge commented May 22, 2026

Uh oh!

maelle commented May 22, 2026

Uh oh!

yabellini left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mpadge commented Apr 20, 2026 •

edited by maelle

Loading