Compartir:
){kind=small}
Lorna es ingeniera de software con un incurable hábito bloguero. Intenta domar las palabras y el código a partes iguales.
Sobrevivir al Hacktoberfest: Guía para mantenedores
Tiempo de lectura: 5 minutos
¡Feliz Hacktoberfest a todos! Colaboradores, espero que lo estéis pasando muy bien aprendiendo nuevas habilidades y descubriendo proyectos en los que podéis marcar la diferencia. Mantenedores, el post de hoy es sólo para vosotros. Esperemos que los cambios en las normas se traduzcan en una mejor calidad de los pull requests para vuestros proyectos, pero aún así puede ser mucho trabajo. Soy mantenedor desde hace mucho tiempo, y hoy me gustaría compartir algunos consejos que espero que te ayuden.
Vonage está encantado de ser socio de Hacktoberfest 2020. No somos no somos ajenos al código abiertocon nuestras bibliotecas, fragmentos de código y demostraciones en GitHub. Para sumergirte por completo en las festividades, asegúrate de visitar nuestra página de página del Hacktoberfest para más detalles sobre todo lo que hemos planeado.
Los mantenedores de proyectos de código abierto hacen este trabajo sobre todo en su tiempo "libre", y es mucho. No es sólo para Hacktober, y gran parte del trabajo puede pasar desapercibido. Este Hacktoberfest, especialmente con los acontecimientos mundiales que nos rodean, es importante tener en cuenta tus prioridades y no perderlas de vista.
Yo sugeriría que tú, tu proyecto y luego sus colaboradores, en ese orden, es un buen orden de prioridades. Un proyecto no es nada sin mantenedores, y muchos son equipos de uno. Los objetivos y la meta del proyecto son una prioridad importante; no hay presión para ampliar el alcance o pivotar el proyecto porque haya llegado un pull request para hacerlo. La alegría del código abierto es que la gente puede utilizar sus propias bifurcaciones como base de un nuevo proyecto si no les gusta cómo diriges las cosas. Y por último, los colaboradores: el Hacktoberfest tiene muchos colaboradores nuevos, pero queremos educarlos para que sean colaboradores, no niños mimados. Así que si necesitan leer las directrices del proyecto antes de contribuir, díselo en lugar de tener que volver a hacerlo tú mismo.
El Hacktoberfest ya es opcional, pero si estás "dentro", es fácil sentirse abrumado, especialmente en un proyecto de alto perfil o ya muy ocupado. La clave es gestionar las notificaciones. Y no, una regla de correo electrónico para archivar o eliminar todo lo que contenga el nombre de tu proyecto no es la solución.
Add a filter to file all incoming mail with the word GitHub in
Dedica algo de tiempo a configurar las notificaciones de GitHub para asegurarte de que recibes las notificaciones que deseas y de que no recibes demasiadas notificaciones que no son relevantes. También puedes enviar diferentes notificaciones para diferentes organizaciones a diferentes direcciones de correo electrónico, lo que puede ser muy útil.
GitHub tiene una excelente documentación de ayuda, así que no repetiré su contenido aquí, ¡pero te dirigiré a los lugares que encuentro más útiles!
En primer lugar, puedes vincular varias direcciones de correo electrónico a una cuenta de GitHub, lo cual es útil si realizas algunos proyectos de trabajo con tu cuenta de GitHub, o utilizas una dirección de correo electrónico diferente para un proyecto de código abierto en particular. Echa un vistazo a la documentación para verificar direcciones de correo electrónico adicionales en GitHub.
A continuación, haz que las notificaciones correctas vayan a la dirección de correo electrónico correcta. Se encuentra en "enrutamiento personalizado" en la configuración de las notificaciones, y por supuesto, hay excelente documentación sobre el enrutamiento de correos electrónicos en GitHub.
La posibilidad de "Vigilar" un repositorio es muy valiosa. Si hay un proyecto del que quieres recibir todas las notificaciones, haz clic en el botón "Watch" de la parte superior y elige "Watching". Esto es útil si necesitas hacer un seguimiento de la actividad en un repositorio en particular.
Quizá sea más valiosa la posibilidad de "desobservar" un proyecto. Me parece que debido a que hago parte del mantenimiento de GitHub en el trabajo, tengo acceso a muchos repositorios, y por defecto, si tienes acceso, ¡estás suscrito a las notificaciones! Esto puede ser bastante ruidoso como puedes imaginar, así que el mismo botón "Watch" nos da algunas otras opciones - el valor por defecto es "Not Watching", por lo que recibirás notificaciones sobre tus propios issues/PRs o si te mencionan. También puedes configurarlo en "Ignorar" si te involucras cuando no quieres.
A nivel de cada repositorio, también puedes recibir notificaciones sin tener que comentar el debate para "participar". Busque el botón de la derecha que dice "Suscribirse" en "Notificaciones". También existe la opción contraria. Supongamos que has comentado algo sobre lo que ya no te interesa recibir notificaciones. En ese caso, puedes "Darte de baja" sólo de un tema o pull request sin tener que darte de baja de todo un repositorio.
Si un pull request no es útil o no cumple los objetivos del proyecto, no tengas miedo de rechazarlo. En Hacktoberfest FAQ es tu amiga. Sé siempre amable, pero las respuestas rápidas son valiosas si tienes disponibilidad para estar al día cada pocos días. Si un pull request se puede hacer aceptable, por ejemplo, porque hace que la compilación falle pero se puede corregir, ofrece algunos comentarios a tu nuevo colaborador explicando qué haría que el pull request estuviera listo para fusionarse. Si se trata de un cambio que no desea (emoji para decorar su README parece una contribución popular), dilo y ciérralo.
El código abierto no siempre es un lugar acogedor, y nosotros operamos en público, por lo que los transeúntes se llevan una buena impresión de nuestros proyectos por la forma en que interactuamos con la gente. Tómate tu tiempo para agradecer a la gente sus aportaciones. Incluso si el pull request no merece el tiempo que te ha llevado leerlo, un simple "Esto no parece útil para el proyecto, ¿por qué no revisas la lista de problemas para ver si hay ideas?" es mucho más acogedor que cerrarlo sin ninguna otra comunicación o explicación.
En esta línea de agradecimiento a los colaboradores, me gustaría terminar dándote las gracias a ti, el mantenedor. Es un error común pensar que los proyectos de código abierto son mantenidos por una figura increíble, distante y heroica. En realidad, quienes dedicamos nuestro tiempo y energía a esta tarea somos personas reales con vidas reales.
Gracias por todo lo que hacéis, el código abierto cambia el mundo y, a vuestra manera, lo estáis haciendo posible.