start policy updates on ai tool usage - #1006
Conversation
|
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! |
|
I'll generate the translations ASAP. |
c191b55 to
7220acd
Compare
|
@maelle I also just added another checkbox to templates/review.md which will also need translating. |
|
@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 |
yabellini
left a comment
There was a problem hiding this comment.
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.
Co-authored-by: Yanina Bellini Saibene <yabellini@gmail.com>
Co-authored-by: Maëlle Salmon <maelle.salmon@yahoo.se>
|
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 😸 |
Co-authored-by: Maëlle Salmon <maelle.salmon@yahoo.se>
yabellini
left a comment
There was a problem hiding this comment.
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?
|
Thanks @yabellini 😄
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? |
|
Yes @mpadge , thank you! |
|
@mpadge in the future please do not merge main into a PR branch, that makes |
|
Fixed the build by re-starting it twice 🤷♀️ |
Sorry about that 😭 I thought I was being helpful ... shan't do that again 😆 |
| 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: |
There was a problem hiding this comment.
| - 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: |
|
|
||
|
|
||
| - 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/); |
There was a problem hiding this comment.
| - ["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/); |
|
|
||
| - 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/); |
There was a problem hiding this comment.
| - ["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. |
There was a problem hiding this comment.
| - 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). |
There was a problem hiding this comment.
| - 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). |
There was a problem hiding this comment.
| - 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í. |
There was a problem hiding this comment.
| - 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: |
There was a problem hiding this comment.
| 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. |
There was a problem hiding this comment.
| > 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. |
There was a problem hiding this comment.
| 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. |
There was a problem hiding this comment.
| 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). |
There was a problem hiding this comment.
| 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. |
There was a problem hiding this comment.
| 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. |
There was a problem hiding this comment.
| 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. |
There was a problem hiding this comment.
| Pedimos a los revisores que sean lo más transparentes posible. | |
| Pedimos a quienes revisan que sean lo más transparentes posible. |
yabellini
left a comment
There was a problem hiding this comment.
I reviewed and suggested changes to the Spanish version. Mostly gender marks and some wording to make it clearer
Checklist for dev guide maintainers, do not delete 😸