HSF training es un proyecto de código abierto, y damos la bienvenida a contribuciones de todo tipo: nuevas lecciones, correcciones de material existente, informes de errores, y revisiones de los cambios propuestos, todos son bienvenidos.
Al contribuir, aceptas que podemos redistribuir tu trabajo bajo nuestra licencia. A cambio, abordaremos tus problemas y/o evaluaremos tu propuesta de cambio lo más pronto posible, y te ayudaremos a convertirte en miembro de nuestra comunidad. Todos los involucrados en HSF training aceptan cumplir con nuestro código de conducta.
La forma más sencilla de empezar es presentar un "issue" para informarnos sobre un error, una redacción incómoda, o un error factual. Esta es una buena manera de presentarte y conocer a algunos de los miembros de nuestra comunidad.
-
Si no tienes una cuenta en GitHub, puedes escribir un correo electrónico a los coordinadores. Sin embargo, podremos responder más rápidamente si utilizas uno de los métodos descritos a continuación.
-
Si tienes una cuenta en GitHub, o estás dispuesto a crear una, pero no sabes cómo usar Git, puedes reportar problemas o sugerir mejoras creando un issue. Esto nos permite asignar el elemento a alguien y responder a él en una discusión encadenada.
-
Si te sientes cómodo con Git, y te gustaría agregar o cambiar material, puedes enviar un "pull request" (PR). Las instrucciones para hacerlo están incluidas a continuación.
Hay muchas formas de contribuir, desde escribir nuevos ejercicios y mejorar los existentes, hasta actualizar o completar la documentación y enviar informes de errores sobre cosas que no funcionan, no están claras o están ausentes. Si buscas ideas, consulta la pestaña 'Issues' para ver una lista de problemas asociados a este repositorio, o también puedes revisar todos los problemas en hsf-training.
También hay una lista de todos los problemas que son particularmente fáciles y adecuados para las primeras contribuciones.
Los comentarios sobre issues y las revisiones de pull requests son igualmente bienvenidos: somos más inteligentes juntos que por separado. Las revisiones de principiantes y recién llegados son especialmente valiosas: es fácil para quienes han estado utilizando estas lecciones durante un tiempo olvidar lo impenetrable que puede ser parte de este material, por lo que siempre se agradecen ojos nuevos.
Si decides contribuir a través de GitHub, es posible que desees consultar Cómo Contribuir a un Proyecto de Código Abierto en GitHub. Para gestionar cambios, seguimos el flujo de GitHub. Cada lección tiene dos mantenedores que revisan problemas y pull requests o animan a otros a hacerlo. Los mantenedores son voluntarios de la comunidad y tienen la última palabra sobre lo que se fusiona en la lección. Para usar la interfaz web para contribuir a una lección:
- Haz un fork del repositorio original a tu perfil de GitHub.
- Dentro de tu versión del repositorio forked, muévete a la rama
mainy crea una nueva rama para cada cambio significativo que se realice. - Navega a los archivos que deseas cambiar dentro de las nuevas ramas y realiza las revisiones necesarias.
- Confirma todos los archivos cambiados dentro de las ramas correspondientes.
- Crea pull requests individuales desde cada una de tus ramas modificadas
a la rama
maindentro del repositorio original. - Si recibes comentarios, realiza cambios utilizando tus ramas específicas del problema del repositorio forked y los pull requests se actualizarán automáticamente.
- Repite según sea necesario hasta que se haya abordado todo el feedback.
Al comenzar a trabajar, asegúrate de que tu clon de la rama main original esté actualizado
antes de crear tus propias ramas específicas de revisión a partir de allí.
Además, por favor, trabaja solo desde tus ramas recién creadas y no
desde tu clon de la rama main original.
Por último, las copias publicadas de todas las lecciones están disponibles en la rama main del repositorio original para referencia mientras revisas.
Más información sobre cómo contribuir o cómo contactarnos: Inicio de HSF training