Nuevas directrices de contribución

Si alguien te dirigió aquí desde un Issue/PR que se cerró automáticamente, por favor no entres en pánico ni sientas que te rechazamos. Casi siempre, cualquier trabajo que hayas hecho terminará integrándose en Exercism, o tu problema se resolverá. Damos la bienvenida a las contribuciones y las fomentamos, pero nos gusta discutir las cosas en nuestro foro antes de lanzarnos al código en GitHub. Abrir un hilo en el foro hará que todo avance.

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

Sin embargo, también soy consciente de que ha generado frustraciones en nuevos contribuidores que se comprometen a ayudar, pero que se sienten bloqueados por nuestro proceso de contribución. Así que hoy quiero presentar algunas pautas nuevas (o más claras) sobre cómo vamos a seguir avanzando 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 discutimos en nuestro foro, y los cambios resultantes en el código los discutimos en GitHub (en las revisiones de PR). La regla secundaria es que (con la excepción de los mantenedores, que son autónomos) discutimos las cosas antes de hacerlas. Nuestro foro permite que contribuidores y mantenedores de todos los tracks compartan conocimientos y experiencia sobre una amplia variedad de lenguajes e ideas, sin necesidad de suscribirse a 300 repositorios distintos en GitHub ni de saturar sus notificaciones.

Guía actualizada

Obtener ayuda

• Si te atascas con algo antes de resolver un ejercicio (por ejemplo, instalar la CLI, ejecutar los tests, o 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 ya resolviste un ejercicio pero tienes dudas sobre él, debes solicitar mentoría en el propio Exercism.

Reportar bugs o issues

• Todos los bugs o issues deben abrirse en nuestro foro, donde muchas personas distintas pueden ayudar a entender y resolver el problema.
  • Si el issue tiene que ver con un lenguaje, usa la categoría Programming/xxx correspondiente.
  • Si es un bug del sitio web, usa la categoría «Bugs & Feature Requests».
• Por lo general, los issues de GitHub se cerrarán automáticamente y quien los publicó será redirigido al foro (con un enlace de un clic para copiar y pegar su issue, como sucede actualmente).
• Los mantenedores de un track pueden desactivar el cierre automático de issues, pero la vía oficial sigue siendo el foro.

Abrir pull requests

• Los pull requests deben 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 el trabajo se haya discutido en el foro. Si la idea detrás de un PR ya fue aprobada, solo agrega un enlace al PR en el hilo correspondiente del foro y lo reabriremos.
• Los mantenedores de un track pueden 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 contribuidores principales, sin quienes Exercism no puede funcionar. Pero también queremos asegurarnos de que Exercism siga siendo un lugar donde gente nueva pueda involucrarse sin barreras demasiado prohibitivas, y donde podamos animar y apoyar a esas personas para que se conviertan ellas mismas en contribuidores principales.

Me entusiasma ver cómo estos cambios afectarán las contribuciones que veamos durante los próximos meses. Volveremos a revisar todo a mediados de 2024.