From e631e3a4507c969b92502747c6bd30053f60c4e5 Mon Sep 17 00:00:00 2001 From: mpadge Date: Fri, 12 Jun 2026 09:38:25 +0200 Subject: [PATCH 01/11] update phrasing of volunteer for in ed, rev info to close #1015 thanks to @joelnitta --- booknews.Rmd | 1 + softwarereview_editor.Rmd | 3 ++- softwarereview_reviewer.Rmd | 3 ++- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/booknews.Rmd b/booknews.Rmd index 078494bbc..336f3767b 100644 --- a/booknews.Rmd +++ b/booknews.Rmd @@ -2,6 +2,7 @@ ## Dev version +- 2026-06-12, clarify expections for volunteer form for eds and revs (#1015; thansk to @joelnitta) - 2026-05-21, clarify that stats must start with a pre-sub (#1011). - 2026-05-21, add comment on updating Airtable rev-prod for new editors (#1005). - 2026-05-21, update docs to require pkg websites at submission (#1004). diff --git a/softwarereview_editor.Rmd b/softwarereview_editor.Rmd index 9ade986d8..f88792d98 100644 --- a/softwarereview_editor.Rmd +++ b/softwarereview_editor.Rmd @@ -304,6 +304,7 @@ In general, at least one reviewer should have prior reviewing experience, and of If needed later, remove reviewers with `@ropensci-review-bot remove @username from reviewers`. - Due dates for reviews are set by default to [21 days](https://github.com/ropensci-org/buffy/blob/20c5ac630ce436a9cd7b698d217a0f680f368aa0/app/responders/ropensci/reviewers_due_date_responder.rb#L162-L164) (3 weeks) after the date of assignment. - If you want to change the due date for a review use `@ropensci-review-bot set due date for @username to YYYY-MM-DD`. +- The bot will automatically ask each reviewer to fill out our [volunteering form](https://ropensci.org/software-reviewer) to ensure they're in the Airtable database. ### During review {#during-review} @@ -364,4 +365,4 @@ For package authors who wish to retain their repositories in their original GitH #### Package promotion {#package-promotion} -- Direct the author to the chapters of the guide about [package releases](#releases), [marketing](#marketing) and [GitHub grooming](#grooming). \ No newline at end of file +- Direct the author to the chapters of the guide about [package releases](#releases), [marketing](#marketing) and [GitHub grooming](#grooming). diff --git a/softwarereview_reviewer.Rmd b/softwarereview_reviewer.Rmd index 94eb744fb..12c8f7b43 100644 --- a/softwarereview_reviewer.Rmd +++ b/softwarereview_reviewer.Rmd @@ -25,7 +25,8 @@ _If you use our standards/checklists etc. when reviewing software elsewhere, do Thank you for your desire to participate in rOpenSci software peer-review as a reviewer! -Please fill our [volunteering form](https://ropensci.org/software-reviewer). +Anybody reading this is encouraged to fill our [volunteering form](https://ropensci.org/software-reviewer) at any time. +If you've already volunteered to review, once you're assigned in a review issue, our bot will also provide the link and automatically ask you to fill out the form. If you see a current submission that is particularly relevant to your interests please email `info@ropensci.org`, including the name of the package, the URL to the submission issue and the name of the assigned editor. However, keep in mind that reviewer invitations are kept at the editor's discretion, and the editor might well have already emailed people. From 15c5da17569cfa280197dbdb4b86023bfa5c8ac0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Thu, 25 Jun 2026 13:35:55 +0200 Subject: [PATCH 02/11] Update softwarereview_reviewer.Rmd Co-authored-by: Joel Nitta --- softwarereview_reviewer.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_reviewer.Rmd b/softwarereview_reviewer.Rmd index 12c8f7b43..774bf0bec 100644 --- a/softwarereview_reviewer.Rmd +++ b/softwarereview_reviewer.Rmd @@ -26,7 +26,7 @@ _If you use our standards/checklists etc. when reviewing software elsewhere, do Thank you for your desire to participate in rOpenSci software peer-review as a reviewer! Anybody reading this is encouraged to fill our [volunteering form](https://ropensci.org/software-reviewer) at any time. -If you've already volunteered to review, once you're assigned in a review issue, our bot will also provide the link and automatically ask you to fill out the form. +If you've already agreed to review, once you're assigned in a review issue, our bot will also provide the link and automatically ask you to fill out the form. If you see a current submission that is particularly relevant to your interests please email `info@ropensci.org`, including the name of the package, the URL to the submission issue and the name of the assigned editor. However, keep in mind that reviewer invitations are kept at the editor's discretion, and the editor might well have already emailed people. From 417dd4af7c9fde2a52376002b4459c973f680ca7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Thu, 25 Jun 2026 13:41:53 +0200 Subject: [PATCH 03/11] translate 1 item --- softwarereview_editor.Rmd | 1 + softwarereview_editor.es.Rmd | 1 + 2 files changed, 2 insertions(+) diff --git a/softwarereview_editor.Rmd b/softwarereview_editor.Rmd index f88792d98..54c5c9621 100644 --- a/softwarereview_editor.Rmd +++ b/softwarereview_editor.Rmd @@ -305,6 +305,7 @@ In general, at least one reviewer should have prior reviewing experience, and of - Due dates for reviews are set by default to [21 days](https://github.com/ropensci-org/buffy/blob/20c5ac630ce436a9cd7b698d217a0f680f368aa0/app/responders/ropensci/reviewers_due_date_responder.rb#L162-L164) (3 weeks) after the date of assignment. - If you want to change the due date for a review use `@ropensci-review-bot set due date for @username to YYYY-MM-DD`. - The bot will automatically ask each reviewer to fill out our [volunteering form](https://ropensci.org/software-reviewer) to ensure they're in the Airtable database. +- O bot solicitará automaticamente a cada revisor que preencha nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) para garantir que ele esteja cadastrado no banco de dados do Airtable. ### During review {#during-review} diff --git a/softwarereview_editor.es.Rmd b/softwarereview_editor.es.Rmd index 5eb9c771d..93da5fb99 100644 --- a/softwarereview_editor.es.Rmd +++ b/softwarereview_editor.es.Rmd @@ -304,6 +304,7 @@ En general, al menos una debe tener experiencia previa en revisiones y, por supu Si es necesario sacar a alguien de la revisión, usa `@ropensci-review-bot remove @username from reviewers`. - Las fechas de vencimiento de las revisiones se fijan por defecto en [21 días](https://github.com/ropensci-org/buffy/blob/20c5ac630ce436a9cd7b698d217a0f680f368aa0/app/responders/ropensci/reviewers_due_date_responder.rb#L162-L164) (3 semanas) después de la fecha de asignación. - Si quieres cambiar la fecha de vencimiento de una revisión utiliza `@ropensci-review-bot set due date for @username to YYYY-MM-DD`. +- El bot le pedirá automáticamente a cada revisor que complete nuestro [formulario de voluntariado](https://ropensci.org/software-reviewer) para asegurarse de que figure en la base de datos de Airtable. ### Durante la revisión {#during-review} From 8dcbbc27d525969c5b11fdf75eee1a0393aa50ab Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Thu, 25 Jun 2026 13:45:58 +0200 Subject: [PATCH 04/11] translate more --- softwarereview_reviewer.es.Rmd | 3 ++- softwarereview_reviewer.pt.Rmd | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/softwarereview_reviewer.es.Rmd b/softwarereview_reviewer.es.Rmd index e84324e7d..4210553ce 100644 --- a/softwarereview_reviewer.es.Rmd +++ b/softwarereview_reviewer.es.Rmd @@ -25,7 +25,8 @@ Si ves una presentación vigente que te sea particularmente interesante, por fav Sin embargo, ten en cuenta que las invitaciones a revisar quedan a discreción quien se encuentra a cargo de la edición, y es muy posible que ya haya realizado invitaciones. Por favor, no te ofrezcas para revisar en todos los *issues* y no te presentes a través de la interfaz de GitHub. -Para otras formas de contribuir, consulta la [Guía de contribución de rOpenSci](https://contributing.ropensci.org/). +Invitamos a todos los que lean esto a que llenen nuestro [formulario de voluntariado](https://ropensci.org/software-reviewer) en cualquier momento. +Si ya te has comprometido a revisar, una vez que se te asigne un número de revisión, nuestro bot también te proporcionará el enlace y te pedirá automáticamente que llenes el formulario. ## Preparar tu revisión {#preparereview} diff --git a/softwarereview_reviewer.pt.Rmd b/softwarereview_reviewer.pt.Rmd index 7ca6fe245..3d20f00f0 100644 --- a/softwarereview_reviewer.pt.Rmd +++ b/softwarereview_reviewer.pt.Rmd @@ -20,7 +20,8 @@ _Se você usar nossos processos, guias, listas de verificação, etc., ao revis Obrigado pelo seu desejo de participar como revisor(a) da revisão por pares de software da rOpenSci! -Por favor, preencha o nosso [formulário de voluntariado](https://ropensci.org/software-reviewer). +Incentivamos todos que estiverem lendo isto a preencher nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) a qualquer momento. +Se você já se comprometeu a revisar, assim que for designado para uma edição de revisão, nosso bot também fornecerá o link e solicitará automaticamente que você preencha o formulário. Se você encontrar alguma submissão que seja particularmente relevante para seus interesses, envie um e-mail para `info@ropensci.org`, incluindo o nome do pacote, a URL da *issue* que corresponde a este envio e o nome do(a) editor(a) responsável. No entanto, lembre-se de que o(a) editor(a) é responsável por indicar os(as) potenciais revisores(as), sendo possível que outras pessoas já tenham sido convidadas. From 3381e1d3cddd96fea9b86ab5d6615ce8e8990899 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Thu, 25 Jun 2026 15:38:14 +0200 Subject: [PATCH 05/11] Update softwarereview_editor.es.Rmd Co-authored-by: Yanina Bellini Saibene --- softwarereview_editor.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_editor.es.Rmd b/softwarereview_editor.es.Rmd index dedc80780..fe8085061 100644 --- a/softwarereview_editor.es.Rmd +++ b/softwarereview_editor.es.Rmd @@ -305,7 +305,7 @@ En general, al menos una debe tener experiencia previa en revisiones y, por supu Si es necesario sacar a alguien de la revisión, usa `@ropensci-review-bot remove @username from reviewers`. - Las fechas de vencimiento de las revisiones se fijan por defecto en [21 días](https://github.com/ropensci-org/buffy/blob/20c5ac630ce436a9cd7b698d217a0f680f368aa0/app/responders/ropensci/reviewers_due_date_responder.rb#L162-L164) (3 semanas) después de la fecha de asignación. - Si quieres cambiar la fecha de vencimiento de una revisión utiliza `@ropensci-review-bot set due date for @username to YYYY-MM-DD`. -- El bot le pedirá automáticamente a cada revisor que complete nuestro [formulario de voluntariado](https://ropensci.org/software-reviewer) para asegurarse de que figure en la base de datos de Airtable. +- El bot le pedirá automáticamente a cada persona que esté revisando que complete nuestro [formulario de voluntariado](https://ropensci.org/software-reviewer) para asegurarse de que figure en la base de datos de Airtable. ### Durante la revisión {#during-review} From 1ba168cb35c1f05de5f2aec70227d03242e1516c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Thu, 25 Jun 2026 15:38:26 +0200 Subject: [PATCH 06/11] Update softwarereview_reviewer.es.Rmd Co-authored-by: Yanina Bellini Saibene --- softwarereview_reviewer.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_reviewer.es.Rmd b/softwarereview_reviewer.es.Rmd index bf7adcf71..a39599317 100644 --- a/softwarereview_reviewer.es.Rmd +++ b/softwarereview_reviewer.es.Rmd @@ -25,7 +25,7 @@ Si ves una presentación vigente que te sea particularmente interesante, por fav Sin embargo, ten en cuenta que las invitaciones a revisar quedan a discreción quien se encuentra a cargo de la edición, y es muy posible que ya haya realizado invitaciones. Por favor, no te ofrezcas para revisar en todos los *issues* y no te presentes a través de la interfaz de GitHub. -Invitamos a todos los que lean esto a que llenen nuestro [formulario de voluntariado](https://ropensci.org/software-reviewer) en cualquier momento. +Invitamos a todas las personas que lean esto a completar nuestro [formulario de voluntariado](https://ropensci.org/software-reviewer) en cualquier momento. Si ya te has comprometido a revisar, una vez que se te asigne un número de revisión, nuestro bot también te proporcionará el enlace y te pedirá automáticamente que llenes el formulario. ## Preparar tu revisión {#preparereview} From 97a4ac3eaef6a955f0a92a92755aa31477945056 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Thu, 25 Jun 2026 15:38:40 +0200 Subject: [PATCH 07/11] Update softwarereview_reviewer.es.Rmd Co-authored-by: Yanina Bellini Saibene --- softwarereview_reviewer.es.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_reviewer.es.Rmd b/softwarereview_reviewer.es.Rmd index a39599317..38dcfc027 100644 --- a/softwarereview_reviewer.es.Rmd +++ b/softwarereview_reviewer.es.Rmd @@ -26,7 +26,7 @@ Sin embargo, ten en cuenta que las invitaciones a revisar quedan a discreción q Por favor, no te ofrezcas para revisar en todos los *issues* y no te presentes a través de la interfaz de GitHub. Invitamos a todas las personas que lean esto a completar nuestro [formulario de voluntariado](https://ropensci.org/software-reviewer) en cualquier momento. -Si ya te has comprometido a revisar, una vez que se te asigne un número de revisión, nuestro bot también te proporcionará el enlace y te pedirá automáticamente que llenes el formulario. +Si ya aceptaste revisar con rOpenSci, una vez que se te asigne un número de revisión, nuestro bot también te proporcionará el enlace y te pedirá automáticamente que llenes el formulario. ## Preparar tu revisión {#preparereview} From 2bf9f3bb45190a688c2066f6d6c93707a84410b2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Thu, 25 Jun 2026 15:44:17 +0200 Subject: [PATCH 08/11] fix, thx @yabellini --- softwarereview_editor.Rmd | 1 - softwarereview_editor.pt.Rmd | 1 + 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_editor.Rmd b/softwarereview_editor.Rmd index 0050bb553..b99fcfd68 100644 --- a/softwarereview_editor.Rmd +++ b/softwarereview_editor.Rmd @@ -310,7 +310,6 @@ In general, at least one reviewer should have prior reviewing experience, and of - Due dates for reviews are set by default to [21 days](https://github.com/ropensci-org/buffy/blob/20c5ac630ce436a9cd7b698d217a0f680f368aa0/app/responders/ropensci/reviewers_due_date_responder.rb#L162-L164) (3 weeks) after the date of assignment. - If you want to change the due date for a review use `@ropensci-review-bot set due date for @username to YYYY-MM-DD`. - The bot will automatically ask each reviewer to fill out our [volunteering form](https://ropensci.org/software-reviewer) to ensure they're in the Airtable database. -- O bot solicitará automaticamente a cada revisor que preencha nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) para garantir que ele esteja cadastrado no banco de dados do Airtable. ### During review {#during-review} diff --git a/softwarereview_editor.pt.Rmd b/softwarereview_editor.pt.Rmd index df09c0c3f..84affd54b 100644 --- a/softwarereview_editor.pt.Rmd +++ b/softwarereview_editor.pt.Rmd @@ -305,6 +305,7 @@ Em geral, pelo menos um(a) revisor(a) deve ter experiência prévia em revisão Se necessário remover alguém da revisão, use o comando `@ropensci-review-bot remove @username from reviewers`. - As datas de vencimento das revisões são definidas por padrão como [21 dias](https://github.com/ropensci-org/buffy/blob/20c5ac630ce436a9cd7b698d217a0f680f368aa0/app/responders/ropensci/reviewers_due_date_responder.rb#L162-L164) (3 semanas) após a data da atribuição. - Se você quiser alterar a data de vencimento de uma revisão, use `@ropensci-review-bot set due date for @username to YYYY-MM-DD`. +- O bot solicitará automaticamente a cada revisor que preencha nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) para garantir que ele esteja cadastrado no banco de dados do Airtable. ### Durante a revisão {#during-review} From 214df5106f9e35e7df6857ff1fc39db89f2c2056 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Fri, 26 Jun 2026 09:50:42 +0200 Subject: [PATCH 09/11] Update softwarereview_editor.pt.Rmd Co-authored-by: Beatriz Milz <42153618+beatrizmilz@users.noreply.github.com> --- softwarereview_editor.pt.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_editor.pt.Rmd b/softwarereview_editor.pt.Rmd index 84affd54b..595a08426 100644 --- a/softwarereview_editor.pt.Rmd +++ b/softwarereview_editor.pt.Rmd @@ -305,7 +305,7 @@ Em geral, pelo menos um(a) revisor(a) deve ter experiência prévia em revisão Se necessário remover alguém da revisão, use o comando `@ropensci-review-bot remove @username from reviewers`. - As datas de vencimento das revisões são definidas por padrão como [21 dias](https://github.com/ropensci-org/buffy/blob/20c5ac630ce436a9cd7b698d217a0f680f368aa0/app/responders/ropensci/reviewers_due_date_responder.rb#L162-L164) (3 semanas) após a data da atribuição. - Se você quiser alterar a data de vencimento de uma revisão, use `@ropensci-review-bot set due date for @username to YYYY-MM-DD`. -- O bot solicitará automaticamente a cada revisor que preencha nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) para garantir que ele esteja cadastrado no banco de dados do Airtable. +- O bot solicitará automaticamente a cada pessoa revisora que preencha nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) para garantir que estejam no banco de dados do Airtable. ### Durante a revisão {#during-review} From bf250a3fd039283a22f246743f88848d211bee0f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Fri, 26 Jun 2026 09:50:51 +0200 Subject: [PATCH 10/11] Update softwarereview_reviewer.pt.Rmd Co-authored-by: Beatriz Milz <42153618+beatrizmilz@users.noreply.github.com> --- softwarereview_reviewer.pt.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_reviewer.pt.Rmd b/softwarereview_reviewer.pt.Rmd index 30f228a14..a416e6cea 100644 --- a/softwarereview_reviewer.pt.Rmd +++ b/softwarereview_reviewer.pt.Rmd @@ -20,7 +20,7 @@ _Se você usar nossos processos, guias, listas de verificação, etc., ao revis Obrigado pelo seu desejo de participar como revisor(a) da revisão por pares de software da rOpenSci! Incentivamos todos que estiverem lendo isto a preencher nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) a qualquer momento. -Se você já se comprometeu a revisar, assim que for designado para uma edição de revisão, nosso bot também fornecerá o link e solicitará automaticamente que você preencha o formulário. +Se você já aceitou o convite de realizar uma revisão, assim que for designado(a) para uma *issue* de revisão, nosso bot também fornecerá o link e solicitará automaticamente que você preencha o formulário. Se você encontrar alguma submissão que seja particularmente relevante para seus interesses, envie um e-mail para `info@ropensci.org`, incluindo o nome do pacote, a URL da *issue* que corresponde a este envio e o nome do(a) editor(a) responsável. No entanto, lembre-se de que o(a) editor(a) é responsável por indicar os(as) potenciais revisores(as), sendo possível que outras pessoas já tenham sido convidadas. From b9b1ac90b577eef6e4a9bb5d5fa4ac77039b189b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ma=C3=ABlle=20Salmon?= Date: Fri, 26 Jun 2026 09:51:12 +0200 Subject: [PATCH 11/11] Update softwarereview_reviewer.pt.Rmd Co-authored-by: Beatriz Milz <42153618+beatrizmilz@users.noreply.github.com> --- softwarereview_reviewer.pt.Rmd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/softwarereview_reviewer.pt.Rmd b/softwarereview_reviewer.pt.Rmd index a416e6cea..658870eb4 100644 --- a/softwarereview_reviewer.pt.Rmd +++ b/softwarereview_reviewer.pt.Rmd @@ -19,7 +19,7 @@ _Se você usar nossos processos, guias, listas de verificação, etc., ao revis Obrigado pelo seu desejo de participar como revisor(a) da revisão por pares de software da rOpenSci! -Incentivamos todos que estiverem lendo isto a preencher nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) a qualquer momento. +Convidamos qualquer pessoa que esteja lendo isto a preencher nosso [formulário de voluntariado](https://ropensci.org/software-reviewer) a qualquer momento. Se você já aceitou o convite de realizar uma revisão, assim que for designado(a) para uma *issue* de revisão, nosso bot também fornecerá o link e solicitará automaticamente que você preencha o formulário. Se você encontrar alguma submissão que seja particularmente relevante para seus interesses, envie um e-mail para `info@ropensci.org`, incluindo o nome do pacote, a URL da *issue* que corresponde a este envio e o nome do(a) editor(a) responsável.