Este capítulo contiene una introducción general a nuestro sistema de revisión por pares de software para paquetes, razones para enviar un paquete, razones para ofrecerse para revisar, por qué nuestras revisiones son abiertas, y agradecimientos a quienes participan del sistema.
Nuestro sistema se ha ampliado recientemente a la revisión por pares de software estadístico.
Si utilizas nuestros estándares, listas de tareas, etc. al revisar software en otro lugar, cuenta que estos materiales proceden de rOpenSci a quienes reciben la revisión (por ejemplo, quien edita la revista, estudiantes, colegas durante una revisión interna de código), y también cuéntanoslo en nuestro foro público, o por correo electrónico si prefieres comentarlo en forma privada.
¿Qué es la revisión por pares de software de rOpenSci?
La suite de paquetes de rOpenSci recibe aportes tanto de personal de la organización, como por miembros de la comunidad, lo que significa que se nutre de una gran diversidad de habilidades y experiencias. Pero, ¿cómo asegurar un buen nivel de calidad? Ahí es donde entra en juego la revisión por pares de software: los paquetes aportados por la comunidad se someten a un proceso de revisión transparente, constructivo, no conflictivo y abierto. El mismo se sustenta principalmente en el trabajo voluntario: desde el rol de edición asociada, gestionando el flujo de información y garantizando que los envíos progresen; personas que crean, envían y mejoran su paquete; personas que revisan paquetes (dos por envío), examinan el código y la experiencia de usuario. Este artículo del blog, escrito por miembros del equipo editorial de rOpenSci es una buena introducción a la revisión por pares de software de rOpenSci. Puedes encontrar más artículos en el blog de rOpenSci sobre el proceso y los paquetes que pasaron por el mismo en la etiqueta “software-peer-review”.
Puedes reconocer los paquetes de rOpenSci que han sido revisados por pares mediante una etiqueta verde que dice “peer-reviewed” en su README (ej. el paquete restez) y por el icono azul en su descripción en la página de paquetes de rOpenSci. Ambos contienen links a la revisión.
En cuanto a la parte técnica, le sacamos el jugo a GitHub: cada proceso de revisión es un issue en el repositorio ropensci/software-review. Por ejemplo, haz click aquí para leer el hilo de revisión del paquete ropenaq. El proceso es una conversación activa hasta que el paquete es aceptado, con dos revisiones externas como momentos importantes. Además, utilizamos funcionalidades de GitHub como las plantillas de issues (como plantilla de envío), y el etiquetado que utilizamos para seguir el progreso de los envíos (desde las revisiones iniciales hasta la aprobación).
¿Por qué enviar tu paquete a rOpenSci?
- En primer lugar, y sobre todo, esperamos que envíes tu paquete para su revisión porque valoras la devolución. Nuestro objetivo es proporcionar una devolución útil a las personas que crearon el paquetes y que nuestro proceso de revisión sea abierto, no conflictivo y centrado en la mejora de la calidad del software.
- Una vez a aceptado, tu paquete seguirá recibiendo apoyo de los miembros de rOpenSci. Mantendrás la propiedad y el control de tu paquete, pero podemos ayudarte con los problemas de mantenimiento continuo, como los relacionados con las actualizaciones de R y las dependencias, y las políticas de CRAN.
- rOpenSci promoverá tu paquete a través de nuestra página web, blog y redes sociales (como Mastodon y Twitter). Los paquetes de nuestra suite también tienen un sitio web de documentación que se construye y despliega automáticamente después de cada push.
- Los paquete de rOpenSci se pueden incluir en otros repositorios como CRAN y BioConductor.
- Los paquetes de rOpenSci que son relevantes para el Journal of Open-Source Software y añaden un artículo corto de acompañamiento pueden beneficiarse, a discreción del equipo editorial de JOSS, de un proceso de revisión acelerado.
- Si escribes un gitbook relacionado a tu paquete, rOpenSci lo difundirá: se puede transferir su código fuente a la organización de GitHub
ropensci-books para ser listado en books.ropensci.org.
¿Por qué revisar paquetes para rOpenSci?
- Como en cualquier proceso de revisión por pares, esperamos que elijas revisar para contribuir a rOpenSci y a las comunidades científicas. Nuestra misión de ampliar el acceso a los datos científicos y promover una cultura de investigación reproducible sólo es posible gracias a los esfuerzos voluntarios de miembros de la comunidad como tú.
- La revisión es una conversación bidireccional. Al revisar los paquetes, tendrás la oportunidad de seguir aprendiendo buenas prácticas de desarrollo de quienes crean y revisan los paquetes.
- La naturaleza abierta de nuestro proceso de revisión te permite establecer redes y conocer colegas y personas con quien colaborar. Nuestra comunidad es amigable y tiene muchos miembros con ganas de ayudar y conocimiento en el desarrollo en R y en muchas otras áreas de la ciencia y la informática científica.
- Para ofrecerte para revisar paquetes, completa este breve formulario con tu información de contacto y tus áreas de conocimiento. Siempre buscamos más personas con experiencia en el desarrollo de paquetes en general y con experiencia en los campos en los que se utilizan los paquetes.
¿Por qué las revisiones son abiertas?
Nuestros hilos de revisión son públicos. Todas las personas involucradas (en roles de autoría, revisión y edición) conocen la identidad del resto y la comunidad en general puede ver o incluso participar en la conversación a medida que se produce. Esto proporciona un incentivo para realizar una revisión minuciosa y proporcionar revisiones constructivas y no conflictivas. Tanto quienes envían paquete como quienes los revisan dicen disfrutar y aprender más de este intercambio abierto y directo. También tiene el beneficio de construir una comunidad, ya que quienes participan tienen la oportunidad de interactuar de manera significativa con nuevas personas. Nuevas colaboraciones han nacido gracias a las ideas surgidas durante el proceso de revisión.
Somos conscientes de que los sistemas abiertos pueden tener inconvenientes. Por ejemplo, en la revisión académica tradicional la revisión por pares con doble ciego puede aumentar la representación de autoras femeninas, lo que sugiere un sesgo en las revisiones abiertas. También es posible que quienes hacen la revisión sean menos críticos en la revisión abierta. Sin embargo, proponemos que la apertura de la conversación de la revisión proporciona un control de la calidad de la revisión y del sesgo; es más difícil hacer comentarios no fundamentados o subjetivos en público sin la cobertura del anonimato. En definitiva, creemos que la comunicación directa y pública quienes desarrollaron el paquete y quienes lo revisan mejora la calidad y la imparcialidad de las revisiones.
Además, tanto quienes envían paquete y quienes los revisan tienen la posibilidad de contactar al equipo editorial por privado si tienen alguna duda o pregunta.
¿Cómo se distingue un paquete que fue revisado?
Personas responsables de edición y revisión
Equipo editorial asociado
El proceso de revisión por pares del software de rOpenSci está dirigido por
-
Noam Ross, EcoHealth Alliance
-
Karthik Ram, rOpenSci
-
Maëlle Salmon, rOpenSci
-
Mark Padgham, rOpenSci
-
Anna Krystalli, University of Sheffield RSE
-
Melina Vidoni, RMIT University (School of Science)
-
Mauro Lepore, 2 Degrees Investing Initiative
-
Laura DeCicco, USGS
-
Julia Gustavsen, Agroscope
-
Emily Riederer, Capital One
-
Adam Sparks, Department of Primary Industries and Regional Development
-
Jeff Hollister, US Environmental Protection Agency