diff --git a/booknews.Rmd b/booknews.Rmd index dee2df7fc..a3c60c2aa 100644 --- a/booknews.Rmd +++ b/booknews.Rmd @@ -2,6 +2,8 @@ ## dev version +- 2025-07-09, add mention of the allcontributors package. (#899) + - 2025-07-01, many typo fixes and English language improvements (#912, `@Moohan`) - 2025-03-11, document drawbacks of renaming widely used package (#831) diff --git a/maintenance_collaboration.Rmd b/maintenance_collaboration.Rmd index 1010517f1..841b2e212 100644 --- a/maintenance_collaboration.Rmd +++ b/maintenance_collaboration.Rmd @@ -137,10 +137,13 @@ See also [Useful Git patterns for real life](https://happygitwithr.com/workflows ### Be generous with attributions {#attributions} -If someone contributes to your repository consider adding them in DESCRIPTION, as contributor ("ctb") for small contributions, author ("aut") for bigger contributions. Traditionally when citing a package in a scientific publication only "aut" authors are listed, not "ctb" contributors; and on `pkgdown` websites only "aut" names are listed on the homepage, all authors being listed on the authors/ page. +If someone contributes to your repository consider adding them in DESCRIPTION, as contributor ("ctb") for small contributions, author ("aut") for bigger contributions. +Traditionally when citing a package in a scientific publication only "aut" authors are listed, not "ctb" contributors; and on `pkgdown` websites only "aut" names are listed on the homepage, all authors being listed on the authors/ page. At a minimum consider adding the name of contributors near the feature/bug fix line in [NEWS.md](#news). +You could also use the [allcontributors R package](https://docs.ropensci.org/allcontributors/) to acknowledge all contributors in the README file. + We recommend your being generous with such acknowledgements, because it is a nice thing to do and because it will make folks more likely to contribute again to your package or other repos of the organization. As a reminder from [our packaging guidelines](#building) if your package was reviewed and you feel that your reviewers have made a substantial contribution to the development of your package, you may list them in the `Authors@R` field with a Reviewer contributor type (`"rev"`), like so: diff --git a/maintenance_collaboration.es.Rmd b/maintenance_collaboration.es.Rmd index fde96a1a8..17a7f1caa 100644 --- a/maintenance_collaboration.es.Rmd +++ b/maintenance_collaboration.es.Rmd @@ -146,6 +146,8 @@ El resto están listadas en una página dedicada. Como mínimo, considera la posibilidad de añadir el nombre de quien contribuyó cerca de la línea de la función o corrección de errores en el archivo [NEWS.md](#news). +También puedes utilizar el paquete R [allcontributors](https://docs.ropensci.org/allcontributors/) para agradecer a todas las personas que contribuyeron en el archivo README. + Te recomendamos reconozcas estas contribuciones generosamente, ya que es algo agradable y porque hará que sea más probable que la gente vuelva a contribuir a tu paquete o a otros repos de la organización. Como recordatorio de [nuestra guía de empaquetado](#building) si tu paquete fue revisado y crees que quienes lo hicieron han hecho una contribución sustancial al desarrollo de tu paquete, puedes usar el campo `Authors@R` con el rol de revisión (`"rev"`), así diff --git a/maintenance_collaboration.pt.Rmd b/maintenance_collaboration.pt.Rmd index 35ce2793a..23f00c4c4 100644 --- a/maintenance_collaboration.pt.Rmd +++ b/maintenance_collaboration.pt.Rmd @@ -140,9 +140,11 @@ Se alguém contribuir para o seu repositório, considere adicioná-la em `DESCRI No mínimo, considere adicionar o nome das pessoas colaboradoras próximo à linha de correção de *feature*/*bugs* em [NEWS.md](#news). +Você também pode usar o pacote R [allcontributors](https://docs.ropensci.org/allcontributors/) para agradecer a todos os colaboradores no arquivo README. + Recomendamos que você seja generoso(a) com esses agradecimentos, porque é uma coisa boa de se fazer e porque isso aumentará a probabilidade de as pessoas contribuírem novamente com o seu pacote ou com outros repositórios da organização. -Como um lembrete de [nossas diretrizes de empacotamento](#building) se o seu pacote foi revisado e você acha que as pessoas revisoras fizeram uma contribuição substancial para o desenvolvimento do seu pacote, você pode listá-las na seção `Authors@R` com um tipo de contribuinte "Revisor" (`"rev"`), da seguinte forma: +Como um lembrete de [nossas diretrizes de empacotamento](#building), se o seu pacote foi revisado e você acha que as pessoas revisoras fizeram uma contribuição substancial para o desenvolvimento dele, você pode listá-las na seção `Authors@R` com um tipo de contribuinte "Revisor(a)" (`"rev"`), da seguinte forma: ``` person("Bea", "Hernández", role = "rev",