Nuevas directrices de contribución

Si has llegado aquí desde un Issue/PR cerrado automáticamente, no entres en pánico ni te sientas rechazado. La mayoría de las veces, cualquier trabajo que hayas hecho acabará fusionándose en Exercism, o tu problema acabará resolviéndose. Damos la bienvenida a las contribuciones y las animamos, pero preferimos hablar de las cosas en nuestro foro antes de lanzarnos al código en GitHub. Abrir un hilo en el foro hará que las cosas avancen.

Durante el último año, hemos estado experimentando con limitar las contribuciones de quienes no son mantenedores para liberar tiempo de nuestros colaboradores principales y permitirles hacer mejoras más importantes en los tracks. Ha funcionado bastante bien. En comparación con 2022, durante 2023 hemos visto el doble de ejercicios nuevos añadidos y el triple de temarios creados. El cambio de metodología ha permitido contribuciones mucho más grandes, menos frustración y menos distracciones para nuestros colaboradores principales.

Sin embargo, también soy consciente de que ha generado frustración en colaboradores nuevos que están comprometidos a ayudar, pero que se sienten bloqueados por nuestro proceso de contribución. Así que hoy quiero proponer algunas pautas nuevas (o aclaradas) sobre cómo vamos a avanzar con las contribuciones durante los próximos meses.

La regla fundamental que hay que entender es que las ideas, los bugs y los issues los hablamos en nuestro foro, y los cambios resultantes en el código los hablamos en GitHub (en las revisiones de PR). La regla secundaria es que (salvo los mantenedores que son autónomos) hablamos de las cosas antes de hacerlas. Nuestro foro permite a colaboradores y mantenedores de todos los tracks compartir conocimientos y sabiduría sobre una amplia variedad de lenguajes e ideas sin necesidad de suscribirse a 300 repositorios distintos en GitHub y saturar sus notificaciones.

Directrices actualizadas

Cómo obtener ayuda

• Si te quedas atascado en algo antes de resolver un ejercicio (p. ej., instalar la CLI, ejecutar los tests, atascarte con la lógica o los requisitos de un ejercicio), nuestros mecanismos de ayuda son la categoría «Exercism Support» del foro y el canal #get-help de nuestro servidor de Discord.
• No usamos GitHub ni el correo electrónico para solicitudes de ayuda.
• Si has resuelto un ejercicio pero tienes dudas sobre él, deberías solicitar mentoría en el propio Exercism.

Cómo informar de bugs y problemas

• Todos los bugs y problemas deberían publicarse en nuestro foro, donde un amplio abanico de personas puede ayudar a entender y resolver el problema.
  • Si el problema está relacionado con un lenguaje, usa la categoría Programming/xxx correspondiente.
  • Si es un bug de la web, usa la categoría «Bugs & Feature Requests».
• Por lo general, los issues de GitHub se cerrarán automáticamente y quien los haya publicado será redirigido al foro (con un enlace de un solo clic para copiar y pegar su issue, como ocurre actualmente).
• Los mantenedores de un track pueden optar por desactivar el cierre automático de issues, pero la vía oficial sigue siendo el foro.

Cómo abrir Pull Requests

• Los Pull Requests deberían discutirse en el foro antes de hacer el trabajo.
• Los Pull Requests de personas que no son miembros de la organización seguirán cerrándose automáticamente, pero a menudo se reabrirán una vez que se haya discutido el trabajo en el foro. Si la idea que hay detrás de un PR ya se ha aprobado, basta con añadir un enlace al PR en el hilo correspondiente del foro y lo reabriremos.
• Los mantenedores de un track pueden optar por desactivar el cierre automático de PRs, pero seguimos recomendando que todos los PRs se discutan primero en el foro.

Resumen

Nuestra primera prioridad sigue siendo proteger el tiempo y la capacidad mental de nuestros colaboradores principales, sin quienes Exercism no puede funcionar. Pero también queremos asegurarnos de que Exercism siga siendo un lugar donde gente nueva pueda participar sin barreras demasiado prohibitivas, y donde podamos animar y apoyar a esas personas para que se conviertan ellas mismas en colaboradoras principales.

Me hace mucha ilusión ver cómo afectan estos cambios a las contribuciones que veamos durante los próximos meses. Revisaremos todo de nuevo a mediados de 2024.