Hacktoberfest es una celebración anual de un mes de duración de proyectos, mantenedores y colaboradores de código abierto. El evento tiene como objetivo promover el código abierto y alentar a los desarrolladores a contribuir.
Hacktoberfest viene con incentivos para los primeros 40,000 participantes que obtengan cuatro solicitudes de extracción fusionadas antes del 31 de octubre. Puedes plantar un árbol a tu nombre o una camiseta de Hacktoberfest.
Todo comienza con su primera solicitud de extracción/fusión.
Registrarse en Hacktoberfest
Para participar en Hacktoberfest, primero debe registrarse para el evento en hacktoberfest.com.
Verás una pantalla similar a esta:
Debe tener una cuenta de GitHub o GitLab para participar.
Elija su servicio de alojamiento preferido y haga clic en el INICIADO botón. Al hacer clic en este botón, se le redirigirá a la aplicación elegida, que le pedirá que apruebe Hacktoberfest.
Autorizar Hacktoberfest te registrará automáticamente para el evento.
Encontrar proyectos para contribuir en GitHub y GitLab
Solo las contribuciones a los proyectos de código abierto participantes en GitHub o GitLab contará para Hacktoberfest. Debe tener una cuenta de GitHub o GitLab para participar.
GitHub
Para encontrar proyectos que participan en Hacktoberfest en GitHub:
- Navegar a github.com.
- Navegue a la barra de búsqueda en GitHub o presione la tecla de barra (/) en su teclado.
- Escriba "Hacktoberfest" y haga clic en el INGRESAR botón.
Seguir los pasos anteriores mostrará varios resultados, con el tema Hacktoberfest en la parte superior. Este tema le dará una lista de repositorios a los que puede contribuir, como se muestra en la imagen a continuación.
Alternativamente, puede ir directamente a la GitHub Hacktoberfest tema.
GitLab
Para encontrar proyectos que participan en Hacktoberfest en GitLab:
- Navegar a gitlab.com.
- En la página de inicio, seleccione explorar proyectos públicos.
- En la página de exploración de proyectos, seleccione explorar temas.
- En el filtrar por búsqueda campo, ingrese "Hacktoberfest".
Seguir los pasos anteriores mostrará varios resultados, con el tema Hacktoberfest como el primero. Este tema le dará una lista de repositorios a los que puede contribuir, como se muestra en la imagen a continuación.
Alternativamente, puede ir directamente a la GitLab Hacktoberfest tema.
Crear una solicitud de extracción (PR) en GitHub
Una solicitud de extracción (PR) es una propuesta realizada por un colaborador de un proyecto que solicita al mantenedor del proyecto que revise y fusione los cambios propuestos en el proyecto.
Para hacer una PR, debes encontrar un proyecto de Hacktoberfest al que quieras contribuir. Una vez que encuentre un proyecto, haga clic en el tenedor botón en la esquina superior derecha:
Bifurcar un proyecto crea una copia del proyecto en su cuenta de GitHub, lo que le permite realizar cambios sin afectar el proyecto principal. Después de bifurcar el proyecto, clone el repositorio desde su cuenta y realice los cambios en su entorno de desarrollo local.
Asegúrese de leer las pautas de contribución del proyecto y sígalas para aumentar las posibilidades de su solicitud de extracción.
Después de realizar los cambios y agregar su versión bifurcada del repositorio, cometer los cambios usando Gity enviarlos a GitHub.
Cuando los cambios se reflejen en GitHub, recibirá un aviso que le informará que su bifurcación se "confirma" antes que la rama principal, como se muestra en la imagen a continuación.
A continuación, haga clic en el contribuir botón en el aviso. Al hacer clic en este botón, se le pedirá que abra una solicitud de extracción, como se muestra en la imagen a continuación.
Luego, haga clic en el solicitud de extracción abierta botón. Esto lo llevará a una página donde revisará las pautas de contribución y un título y una descripción para su solicitud de extracción.
Rellene los campos obligatorios y haga clic en el Crear solicitud de extracción botón, como se muestra en la imagen de abajo.
Has creado una solicitud de extracción. Ahora, espere a que los mantenedores del proyecto revisen y fusionen o rechacen su contribución.
Crear una solicitud de combinación en GitLab
Una solicitud de fusión es idéntica a una solicitud de extracción. La única diferencia son sus respectivos nombres.
Para realizar una solicitud de fusión, primero debe encontrar un proyecto de Hacktoberfest al que desee contribuir. Una vez que encuentre un proyecto, haga clic en el botón de bifurcación en la esquina superior derecha:
Bifurcar un proyecto crea una copia del proyecto en su cuenta de GitLab, lo que le permite realizar cambios sin afectar el proyecto principal. Después de bifurcar el proyecto, clone el repositorio desde su cuenta y realice los cambios en su entorno de desarrollo local.
Asegúrese de leer las pautas de contribución del proyecto y sígalas para aumentar las posibilidades de su solicitud de extracción.
Después de realizar los cambios y agregar su versión bifurcada del repositorio, confirme los cambios y empujarlos a GitLab.
Una vez que haya enviado sus cambios a GitLab, navegue hasta su proyecto bifurcado y haga clic en Fusionar solicitudes en la barra lateral. Aparecerá una pantalla que explica una solicitud de fusión y una Nueva solicitud de fusión botón. Haga clic en el Nueva solicitud de fusión botón, como se muestra en la imagen de abajo.
A continuación, deberá seleccionar un fuente y objetivo rama. El fuente branch debe ser la rama donde residen los cambios que desea confirmar en el repositorio principal. El objetivo La rama debe ser el repositorio principal donde desea confirmar sus cambios. Después de seleccionar las sucursales, haga clic en el Compara sucursales y continúa botón, como se muestra en la imagen de abajo.
Al hacer clic en el Compara sucursales y continúa El botón lo llevará a una página donde puede ingresar un título y una descripción para su solicitud de fusión.
Complete los datos requeridos y haga clic en el Crear botón de solicitud de fusión, como se muestra en la imagen de abajo.
Al hacer clic en este botón, se crea su solicitud de fusión. Ahora debe esperar a que los mantenedores del proyecto revisen y fusionen o cierren su solicitud de incorporación de cambios.
Términos y Condiciones de Hacktoberfest
Todas las contribuciones realizadas a los proyectos de Hacktoberfest deben estar dentro de los límites de Hacktoberfest y no ser spam. No seguir las reglas de Hacktoberfest puede atraer la descalificación del evento.
Hacktoberfest emite un período de revisión de siete días para las solicitudes de extracción/fusión que siguen todas las pautas. Si su PR es bueno, el proyecto debería aceptarlo para Hacktoberfest dentro de ese plazo.
¡Feliz contribución!
