Agradeciendo a tus revisores y revisoras: la gratitud a través de los metadatos semánticos

En rOpenSci, nuestro proceso de revisión por pares de paquetes R se basa en el duro trabajo de muchos revisores voluntarios. Estos miembros de la comunidad donan su tiempo y su experiencia para mejorar la calidad de los paquetes de rOpenSci y ayudar a introducir las mejores prácticas en el software científico.

Nuestro proceso de revisión abierto, en el que las revisiones y los revisores son públicos, significa que uno de los beneficios para las personas que revisan es que pueden obtener reconocimiento por sus revisiones. Queremos que los revisores obtengan el mayor beneficio posible, y que sus contribuciones queden registradas como parte del intelecto académico, por lo que hemos estado trabajando para que las revisiones sean visibles y detectables.

Por eso estamos muy entusiasmados por el pequeño cambio en la versión de ayer de R 3.4.4.

Si estás utilizando R 3.4.3 y escribes utils:::MARC_relator_db_codes_used_with_R en la consola, obtendrás lo siguiente:

> utils:::MARC_relator_db_codes_used_with_R
 [1] "aut" "com" "ctr" "ctb" "cph" "cre" "dtc" "fnd" "ths" "trl"

Con la versión 3.4.4, obtendrás esto:

> utils:::MARC_relator_db_codes_used_with_R
 [1] "aut" "com" "ctr" "ctb" "cph" "cre" "dtc" "fnd" "rev" "ths" "trl"

¿Qué es ese pequeño "rev" que aparece noveno? ¡Es la inclusión oficial de “Revisor” como función de autor del paquete R!

Estos códigos de tres letras proceden del términos MARC (Catalogación legible por máquina) un conjunto estándar de tipos de autoría creado originalmente para algunos de los primeros sistemas informatizados de bibliotecas. R utiliza estos códigos para distinguir entre distintos tipos de autores de paquetes. Puede que estés familiarizado con algunos de estos términos que aparecen en DESCRIPTION por ejemplo.

Authors@R: person("Scott", "Chamberlain", role = c("aut", "cre"), 
       comment = c(ORCID = "0000-0003-1444-9135"))

Aquí aut y cre significan “Autor” y “Creador”, indicando que Scott es el creador original y principal de un paquete. También habrás visto ctb (Colaborador) o cph (Titular de los derechos de autor ¹ ).

Los descriptores estándar como éste son importantes porque permiten que la información sobre la autoría sea legible por una máquina y que se catalogue y transfiera el crédito del trabajo de los autores. Cuando los metadatos sobre los paquetes de R se muestran en los archivos de ayuda o en los sitios web, queda claro el papel que ha desempeñado cada uno. Estos metadatos también son fundamentales para crédito transitivo la importante tarea de seguir las contribuciones a través de cadenas de dependencias para proporcionar un reconocimiento a los desarrolladores de software y a los proveedores de datos que el sistema tradicional de citas a menudo pasa por alto.

Aunque hay muchos más ² términos de relator MARC, R sólo permite un pequeño conjunto que tienen sentido en el contexto de los paquetes de software. Éstos se encuentran enutils:::MARC_relator_db_codes_used_with_R. Los códigos que queden fuera de este conjunto no pasarán la comprobación CMD de R y no estarán permitidos en CRAN.

Creemos que los revisores contribuyen de forma importante a la calidad del software publicado. Por eso el año pasado pedimos a R-Core que añadiera "rev" (Revisor), a la lista de tipos de colaboradores permitidos. Y he aquí que Kurt Hornik hizo el cambio en nuestro nombre ³ . Ya está en la versión de lanzamiento de R.

Dado que CRAN utiliza la versión de desarrollo de R para comprobar y diseñar paquetes, la opción ha estado realmente disponible en CRAN durante un tiempo. Un grupo de autores ya ha estado avisando a los revisores de esta forma en sus archivos DESCRIPTION del paquete.

Esperamos ver la inclusión de los agradecimientos de los revisores en los metadatos de software más allá de rOpenSci. Pueden adoptarlo los autores que envían a JSS, JOSS o cualquier revista o proceso en el que los revisores hagan comentarios significativos sobre el código o la documentación del software. Para el software no R, estamos trabajando en incluir a los revisores en codemeta una norma de metadatos de software multilingüe.

Algunas notas sobre cómo este desarrollo se relaciona específicamente con el proceso de revisión por pares de rOpenSci:

• En primer lugar, es 100% decisión de los autores del paquete decidir si los revisores hicieron una contribución suficiente para ser incluidos en Authors de esta forma. Aunque promovemos esta opción en general nunca pediremos a un autor que incluya específicamente a un revisor. Al igual que la sección de agradecimientos de un manuscrito, la sección Author está bajo el control de los desarrolladores. También depende de los revisores si quieren que se incluya, por lo que los autores de paquetes deben preguntar primero a los revisores.

• En segundo lugar, los editores de rOpenSci deben no figurar en Authors. "edt" (Editor) no es una función de autoría R válida, y estamos demasiado lejos para que se nos incluya. Pero nos sentimos halagados por quienes nos lo han pedido.

• Por último, si incluyes a los revisores de este modo, creemos que lo mejor seria incluir información que se enlace de nuevo a la revisión, de este modo:

  person("Bea", "Hernández", role = "rev",
         comment = "Bea reviewed the package for rOpenSci, see 
                    https://github.com/ropensci/software-review/issues/116")
  

Estamos muy entusiasmados con este desarrollo y con cómo puede mejorar los incentivos para la revisión por pares. Gracias a R-core por subirse a bordo con esto, ¡y a los primeros usuarios que lo probaron!

Atentamente,

c(
    person("Noam", "Ross", role = c("aut", "cre", "lbt")),
    person("Maëlle", "Salmon", role = c("rev", "med"),
           comment = "Comments to improve structure of the introduction")
    person("Karthik", "Ram", role = c("rev", "elt"),
         comment = "Fixed a small typo"),
    person("Scott", "Chamberlain", role = c("rev", "sce"),
           comment = "Agrees with Maëlle about the intro.")
  )