Add mentorship section to template + editor guide (#644)

Co-authored-by: Yanina Bellini Saibene <[email protected]> Co-authored-by: Maëlle Salmon <[email protected]>
ropensci · Sep 15, 2023 · 0bddf4c · 0bddf4c
1 parent e61278e
commit 0bddf4c
Show file tree

Hide file tree

Showing 4 changed files with 16 additions and 3 deletions.
diff --git a/softwarereview_editor.Rmd b/softwarereview_editor.Rmd
@@ -83,11 +83,13 @@ Your tools for searching reviewers in the Airtable are
 
 ![Screenshot of the Airtable filters interface with a filter on domain expertise that has to include chemistry and technical areas that have to include continuous integration](images/airtable.png)
 
-- creating a duplicated [view](https://support.airtable.com/hc/en-us/articles/202624989-Guide-to-views), depending on your Airtable skills.
+* creating a personal [view](https://support.airtable.com/hc/en-us/articles/202624989-Guide-to-views), depending on your Airtable skills.
 
 Have a look at the `last_time_contacted` and `last_answer` columns before contacting someone!
 If someone recently refused because they were busy, it might be best to abstain, whereas someone who refused because of a COI could be contacted again without waiting too long.
 
+Also, please check if a first-time reviewers have indicated that they `require_mentorship`.  If so, please use the mentorship portion of the email template and be prepared to provide additional guidance.
+
 ##### Storing information from the reviewer search in Airtable {#airtable-info}
 
 For people listed in the Airtable, if you contact them about a review please update the `last_time_contacted` column, and enter the category corresponding to their answer in `last_answer`.

diff --git a/softwarereview_editor.es.Rmd b/softwarereview_editor.es.Rmd
@@ -78,11 +78,13 @@ Tus herramientas para buscar personas para la revisión en *Airtable* son
 
 ![Captura de pantalla de la interfaz de filtros de Airtable con un filtro sobre conocimientos técnicos que tiene que incluir química y en áreas técnicas tienen que incluir integración continua (interfaz y etiquetas en inglés)](images/airtable.png)
 
-- crear una [visualización duplicada](https://support.airtable.com/hc/en-us/articles/202624989-Guide-to-views), dependiendo de tus conocimientos de Airtable.
+- crear una [visualización personalizada](https://support.airtable.com/hc/en-us/articles/202624989-Guide-to-views) dependiendo de tus habilidades en Airtable.
 
 Echa un vistazo a los campos `last_time_contacted` (último contacto) y `last_answer` (última respuesta) antes de ponerte en contacto con alguien.
 Si alguien se ha negado recientemente porque no tenía tiempo, podría ser mejor abstenerse, mientras que no hace falta esperar demasiado para volver a invitar a alguien que se negó debido a conflictos de interés.
 
+Además, comprueba si una persona que es nueva revisando ha indicado que `require_mentorship`.  En caso afirmativo, utiliza la parte de tutoría de la plantilla de correo electrónico y prepárate para proporcionar orientación adicional.
+
 ##### Almacenar la información de la búsqueda en Airtable  {#airtable-info}
 
 Si contactas a alguien desde Airtable, actualiza el campo `last_time_contacted` e introduce la categoría correspondiente a su respuesta en `last_answer`.

diff --git a/templates/request.es.md b/templates/request.es.md
@@ -13,7 +13,11 @@ Nuestro objetivo es que las revisiones sean abiertas, no conflictivas y centrada
 ¡Sé amable!
 Consulta nuestra guía de revisión y el [código de conducta](https://ropensci.org/code-of-conduct/) para más información.
 
-¿Puedes revisar? Si no puedes, siempre nos sirve si puedes sugerir personas alternativas. Si no tengo noticias tuyas en el plazo de una semana, supondré que no puedes hacer una revisión en este momento.
+[SI SE SOLICITÓ TUTORÍA: Has indicado en tu formulario que te gustaría tener tutoría para tu primera revisión.  
+Sientete libre de contactarme cuando lo necesites durante este proceso, lo que incluye hacer preguntas por correo electrónico y Slack (recibirás una invitación al Slack de rOpenSci), y compartir borradores de revisiones para recibir devoluciones antes de publicarlas. 
+También me encantará hacer una breve videollamada para explicar el proceso. Por favor, házmelo saber en tu respuesta si quieres programar una.]
+
+¿Puedes revisar? Si no puedes, siempre nos sirve si puedes sugerir a otras personas. Si no tengo noticias tuyas en el plazo de una semana, supondré que no puedes hacer una revisión en este momento.
 
 Gracias por tu tiempo.
 

diff --git a/templates/request.md b/templates/request.md
@@ -13,6 +13,11 @@ We aim for reviews to be open, non-adversarial, and focused on improving softwar
 Be respectful and kind! 
 See our reviewers guide and [code of conduct](https://ropensci.org/code-of-conduct/) for more.
 
+[IF MENTORSHIP REQUESTED: You indicated in your form that you'd prefer mentorship for your first review.  
+You are free to use me as a resource during this process, including asking questions by email and Slack (you will receive an invite to the rOpenSci Slack), and sharing draft reviews for feedback before posting. 
+I'm also happy to have a brief videocall to walk through the process.  
+Please let me know in your reply if you would like to schedule one.]
+
 Are you able to review? If you can not, suggestions for alternate reviewers are always helpful. If I don't hear from you within a week, I will assume you are unable to
 review at this time.