Agradecendo a seus revisores: Gratidão por meio de metadados semânticos

Na rOpenSci, nosso [processo de revisão por pares de pacotes R] conta com o trabalho árduo de muitas pessoas revisoras voluntárias. Essas pessoas da comunidade doam seu tempo e sua experiência para melhorar a qualidade dos pacotes da rOpenSci e ajudar a introduzir práticas recomendadas em softwares científicos.

No nosso processo de revisão aberto, em que as revisões e os(as) revisores(as) são públicos, um benefício para as pessoas que revisam pacotes é que elas podem receber crédito por suas revisões. Queremos que os(as) revisores(as) tenham o máximo de benefícios possível e que suas contribuições sejam registradas como parte da trilha intelectual do trabalho acadêmico, portanto, estamos trabalhando para tornar as revisões visíveis e detectáveis.

É por isso que estamos muito animados com uma pequena alteração no lançamento do R versão 3.4.4, que aconteceu ontem.

Se você estiver executando o R 3.4.3 e digitar utils:::MARC_relator_db_codes_used_with_R no console, você verá o seguinte:

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

Na versão 3.4.4, você obtém o seguinte:

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

O que é esse pequeno "rev" que aparece, o terceiro a partir da direita? É a inclusão oficial de “Revisor(a)” como uma categoria de autoria de pacotes em R!

Esses códigos de três letras vêm dos termos MARC (Machine-Readable Cataloging - Catalogação legível por máquina), um conjunto padrão de tipos de autoria originalmente criado para alguns dos primeiros sistemas informatizados de bibliotecas. O R usa esses códigos para distinguir entre diferentes tipos de autoria de pacotes. Você pode estar familiarizado com alguns desses termos que aparecem em DESCRIPTION como, por exemplo:

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

Neste exemplo, aut e cre significam “Author” (autor) e “Creator” (criador), indicando que Scott é o criador original e principal de um pacote. Você também pode ter visto ctb (Contribuidor) ou cph (Copyright Holder - Detentor dos direitos autorais ¹).

Descritores padrão como esse são importantes porque permitem que as informações sobre autoria sejam legíveis por máquina e que o crédito pelo trabalho das pessoas autoras seja catalogado e transferido. Quando os metadados sobre os pacotes R são exibidos em arquivos de ajuda ou em sites, fica claro o papel que cada pessoa desempenhou. Esses metadados também são essenciais para crédito transitivo, a importante tarefa de rastrear as contribuições por meio de cadeias de dependências, de modo a reconhecer as pessoas desenvolvedoras de software e os provedores de dados que o sistema de citação tradicional geralmente não reconhece.

Embora existam muitos outros² termos MARC para relatores, o R permite apenas um pequeno conjunto que faz sentido no contexto de pacotes de software. Esses termos são encontrados emutils:::MARC_relator_db_codes_used_with_R. Os códigos fora desse conjunto não passarão na verificação CMD do R e não são permitidos no CRAN.

Acreditamos que os(as) revisores(as) por pares fazem uma contribuição importante para a qualidade do software publicado. Por isso, no ano passado, solicitamos ao R-Core que adicionasse "rev" (Revisor(a)) à lista de tipos de colaboradores permitidos. E eis que Kurt Hornik fez a mudança em nosso nome³ . Agora ela está na versão estável do R.

Como o CRAN usa a versão de desenvolvimento do R para checar e fazer o build de pacotes, a opção já está disponível no CRAN há algum tempo. Alguns autores já estão informando os(as) revisores(as) dessa forma no arquivo DESCRIPTION dos pacotes.

Esperamos ver a adoção de agradecimentos de revisores em metadados de software além da rOpenSci. Pode ser utilizado por pessoas que submetem ao JSS, JOSS ou qualquer periódico ou processo em que os(as) revisores(as) façam comentários significativos sobre o código ou a documentação do software. Para software não-R, estamos trabalhando em incluir revisores no codemeta, um padrão de metadados de software em várias linguagens.

Algumas observações sobre como esse desenvolvimento se relaciona especificamente com o processo de revisão por pares da rOpenSci:

• Em primeiro lugar, é 100% escolha dos(as) autores(as) do pacote decidir se os(as) revisores(as) fizeram uma contribuição suficiente para serem incluídos no Authors dessa forma. Embora promovamos essa opção em geral, nunca pediremos a um(a) autor(a) que inclua especificamente um(a) revisor(a). Assim como a seção de agradecimentos de um manuscrito, a seção Author está sob o controle de quem desenvolve o pacote. Também cabe aos revisores decidir se querem ser incluídos, portanto, os(as) autores(as) de pacotes devem perguntar aos(as) revisores(as) primeiro.

• Em segundo lugar, editores do rOpenSci devem não ser listados em Authors. "edt" (Editor) não é uma função de autoria R válida, e estamos muito distantes para sermos incluídos. Mas ficamos lisonjeados com a solicitação.

• Por fim, se você incluir revisores(as) dessa forma, achamos que é uma prática recomendada incluir informações com links para a revisão, assim:

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

Estamos muito animados com esse desenvolvimento e como ele pode melhorar os incentivos para a revisão por pares. Agradecemos ao R-core por ter se juntado a nós, e às primeiras pessoas que o testaram!

Atenciosamente,

c(
    person("Noam", "Ross", role = c("aut", "cre", "lbt")),
    person("Maëlle", "Salmon", role = c("rev", "med"),
           comment = "Comentários para melhorar a estrutura da introdução")
    person("Karthik", "Ram", role = c("rev", "elt"),
         comment = "Corrigiu um pequeno erro de digitação"),
    person("Scott", "Chamberlain", role = c("rev", "sce"),
           comment = "Concorda com a Maëlle sobre a introdução")
  )