viernes, 1 de julio de 2022 From rOpenSci (https://deploy-preview-994--ropensci.netlify.app/es/blog/2022/07/01/evaluating-github-activity-for-contributors/). Except where otherwise noted, content on this site is licensed under the CC-BY license.
Supongamos que tienes que informar de un error o solicitar una función para un paquete. ¿Cómo puedes utilizar la información de GitHub para gestionar tus expectativas (si habrá una solución rápida) y tus acciones (si debes seguir adelante y hacer un fork del repositorio)? En este post, repasaremos diferentes fuentes de información y explicaremos cómo se pueden utilizar. Al final, no hay una receta mágica, excepto quizás la amabilidad, ya que el software lo hacen las personas 😉
Mira si el repositorio está archivado en GitHub.
Si se archiva el repositorio, está claro que los autores ya no van a trabajar en él.
Si te interesa mucho el destino de un paquete de R, puede que tenga sentido empezar a seguir su repositorio de forma personalizada en GitHub: por ejemplo, puedes elegir que se te notifiquen todas las ediciones y PRs o sólo las versiones.
Se debe tener en cuenta que si sólo sigues (watch) un repositorio apareces públicamente como seguidor, pero hasta donde yo se quienes siguen los repositorios con opciones personalizadas no aparecen públicamente.
Observar la actividad en el repositorio te hará consciente de
Ahora bien, no te servirá de nada si ahora mismo estás mirando un repositorio que antes no seguías, pero es bueno saberlo para la próxima vez.
Si el repositorio tiene una guía de contribución (archivo CONTRIBUTING.md o .github/CONTRIBUTING.md) y parece que se ha personalizado al menos un poco en comparación con un modelo estándar, préstale atención :smile_cat:
Si los documentos contienen alguna mención al ciclo de vida del desarrollo (una etiqueta, algún texto), también tenelo en cuenta.
Por último, pero no menos importante, ¡ver que el repositorio tiene un código de conducta puede ayudar a sentirse seguro! El código de conducta de rOpenSci se aplica a todos los paquetes de rOpenSci.
Es información directa de las personas que mantienen el paquete sobre lo que esperan de las contribuciones, por lo que puede ayudarte a orientarte sobre cómo hacer contribuciones y qué tipo de contribuciones son bienvenidas.
En la página principal del repositorio de GitHub puedes encontrar el tiempo transcurrido desde el último commit en la rama por defecto. En la página de branches puedes ver que hay actividad en el código en otra rama (ver por ejemplo https://github.com/ropensci/readODS/branches). En la pestaña de versiones puedes ver la antigüedad de la última versión publicada, y si hay una regularidad en las versiones (ver por ejemplo https://github.com/ropensci/magick/releases).
Si hay actividad en curso, en el código, tus contribuciones podrían abordarse más rápidamente. Si ves que la actividad en el código es intermitente (los desarrolladores se centran en él durante un periodo de tiempo, publican una nueva versión y luego ignoran las notificaciones durante un tiempo), está bien suponer que tendrás que ser paciente.
Ordena los issues y PRs por la fecha de actualización para ver los más recientes primero (este es el valor por defecto cuando se utiliza la extensión para navegadores de internet RefinedGitHub). ¿Las personas que son parte del repositorio responden activamente a los issues?
Mira los hitos: ¿cuál es el contenido de los distintos hitos? ¿Hay fechas previstas de publicación? (Véase, por ejemplo https://github.com/ropensci/dev_guide/milestones.)
Si los problemas obtienen una primera respuesta de una persona de forma rápida, qué suerte, puedes preguntar educadamente lo que querías preguntar y esperar una respuesta bastante rápida. Si la planificación es transparente y actual (es difícil curar los hitos :sweat_smile:), puedes hacerte una idea de dónde encajará tu contribución.
Identifica a los principales colaboradores:
Dirígete a su perfil de GitHub, e incluso a su perfil de R-universe ¿Han estado trabajando en otras cosas? ¿Tienen algún estatus (permiso parental, vacaciones)? ¿Hay algún desajuste entre la organización del repositorio y el trabajo del colaborador?
A veces puede haber algo obvio: si la persona que mantiene el paquete cambió de trabajo, quizá abandonó el interés en este repositorio. Sin embargo, lo más importante es que, aunque ayuda estar al tanto de la actividad pública de quienes contribuyen nunca sabes por lo que está pasando una persona, así que sé amable y paciente.
Dirígete a la página de estado de integración continua de los repositorios, por ejemplo puede ser la pestaña Acciones. Mira el estado de CRAN si el paquete estuvo alguna vez en CRAN.
Los fallos en las comprobaciones que no se abordan pueden indicar que no se trabaja activamente en el repositorio.
En este post hemos resumido algunas fuentes de información que tú, como colaborador potencial, puedes utilizar para evaluar si un repositorio está activo y en qué medida, para calibrar tus expectativas y ofertas de contribución. Si un repositorio parece especialmente abandonado, quizás podrías enviar un correo electrónico a los autores para preguntarles si está previsto realizar trabajos en el futuro y, en caso contrario, si podrías hacerte cargo de él. Sé considerado en todas tus interacciones con las personas que mantienen software.
Si eres la persona que mantiene un paquete de rOpenSci y necesitas ayuda puntual o apoyo para el mantenimiento a largo plazo, ponte en contacto con nosotros en info@ropensci.org.
Por ejemplo, podemos añadir una convocatoria de co-mantenedores en nuestro boletín mensual.
