All posts (Page 3 of 4)
Todos os pacotes enviados para revisão por pares com o rOpenSci são verificados pelo nosso pacote pkgcheck. Esta publicação descreve uma nova ação do GitHub (GitHub Action) que pode ser usada para executar o pkgcheck.
Desde o início deste ano, passamos a compilar automaticamente os arquivos binários e a renderizar a documentação com pkgdown para todos os pacotes da rOpenSci. Um problema que encontramos é que alguns pacotes incluem vinhetas (vignettes) que exigem algumas ferramentas, dados, credenciais especiais, que não estão disponíveis em servidores de compilação genéricos.
Esta postagem explica como você pode incluir essas vinhetas e artigos em seu pacote .
🔗
Sobre vinhetas de pacotes
Por padrão, o R recria automaticamente as vinhetas durante o R CMD check ou ao gerar sites pkgdown executando todo o código do R. Isso é útil porque fornece alguns testes extras do seu código e garante que a documentação seja reprodutível. No entanto, às vezes não é uma boa ideia executar o código em todos os servidores de compilação, todas as vezes. Por exemplo:
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.
...Tudo começou em 26 de janeirode deste ano, quando me inscrevi para ser voluntária como como revisora de pacotes R enviados para a rOpenSci. Minha principal motivação para querer ser voluntária foi aprender algo novo e contribuir com a comunidade R de código aberto. Se você está se perguntando por que as pessoas por trás da rOpenSci estão fazendo isso, você pode ler Como a rOpenSci usa a revisão de código para promover a ciência reprodutível....
