Hacktoberfest est une célébration annuelle d'un mois de projets open source, de mainteneurs et de contributeurs. L'événement vise à promouvoir l'open source et à encourager les développeurs à y contribuer.
Hacktoberfest est livré avec des incitations pour les 40 000 premiers participants qui reçoivent quatre demandes d'extraction fusionnées d'ici le 31 octobre. Vous pouvez soit faire planter un arbre à votre nom, soit un t-shirt Hacktoberfest.
Tout commence par votre première demande de pull/merge.
Inscription à la Hacktoberfest
Pour participer au Hacktoberfest, vous devez d'abord vous inscrire à l'événement sur hacktoberfest.com.
Vous verrez un écran semblable à celui-ci :
Vous devez avoir un compte GitHub ou GitLab pour participer.
Choisissez votre service d'hébergement préféré et cliquez sur le LANCER bouton. En cliquant sur ce bouton, vous serez redirigé vers l'application choisie, qui vous demandera d'approuver Hacktoberfest.
L'autorisation de Hacktoberfest vous inscrira automatiquement à l'événement.
Trouver des projets auxquels contribuer sur GitHub et GitLab
Seules les contributions aux projets open source participants sur GitHub ou GitLab comptera pour le Hacktoberfest. Vous devez avoir un compte GitHub ou GitLab pour participer.
GitHub
Pour trouver des projets participant au Hacktoberfest sur GitHub :
- Aller vers github.com.
- Accédez à la barre de recherche sur GitHub ou appuyez sur la touche barre oblique (/) sur votre clavier.
- Tapez "Hacktoberfest" et cliquez sur le ENTRER bouton.
Suivre les étapes ci-dessus affichera plusieurs résultats, avec le sujet Hacktoberfest tout en haut. Cette rubrique vous donnera une liste de référentiels auxquels vous pouvez contribuer, comme indiqué dans l'image ci-dessous.
Alternativement, vous pouvez accéder directement au GitHub Hacktoberfest sujet.
GitLab
Pour trouver des projets participant au Hacktoberfest sur GitLab :
- Aller vers gitlab.com.
- Sur la page d'accueil, sélectionnez explorer les projets publics.
- Sur la page Explorer les projets, sélectionnez explorer des sujets.
- Dans le filtrer par recherche champ, entrez "Hacktoberfest".
Suivre les étapes ci-dessus affichera plusieurs résultats, le sujet Hacktoberfest étant le tout premier. Cette rubrique vous donnera une liste de référentiels auxquels vous pouvez contribuer, comme indiqué dans l'image ci-dessous.
Alternativement, vous pouvez accéder directement au GitLab Hacktoberfest sujet.
Création d'une demande d'extraction (PR) sur GitHub
Une demande d'extraction (PR) est une proposition faite par un contributeur à un projet demandant au mainteneur du projet d'examiner et de fusionner les modifications proposées au projet.
Pour faire un PR, vous devez trouver un projet Hacktoberfest auquel vous souhaitez contribuer. Une fois que vous avez trouvé un projet, cliquez sur le fourchette bouton en haut à droite :
Forker un projet crée une copie du projet dans votre compte GitHub, ce qui vous permet d'apporter des modifications sans affecter le projet principal. Après avoir forké le projet, clonez le référentiel à partir de votre compte et apportez les modifications à votre environnement de développement local.
Assurez-vous de lire les directives de contribution du projet et de les suivre pour augmenter les chances de votre pull request.
Après avoir apporté les modifications et ajouté votre version fourchue du référentiel, commiter les changements en utilisant Git, et poussez-les vers GitHub.
Lorsque les modifications se répercuteront sur GitHub, vous recevrez une invite vous informant que votre fork est "validé" avant la branche principale, comme indiqué dans l'image ci-dessous.
Ensuite, cliquez sur le contribuer bouton sur l'invite. En cliquant sur ce bouton, vous serez invité à ouvrir une demande d'extraction, comme indiqué dans l'image ci-dessous.
Ensuite, cliquez sur le ouvrir une demande d'extraction bouton. Cela vous mènera à une page où vous passerez en revue les directives de contribution et un titre et une description pour votre pull request.
Remplissez les champs requis et cliquez sur le Créer une demande d'extraction bouton, comme indiqué dans l'image ci-dessous.
Vous avez créé une pull request. Maintenant, attendez que les mainteneurs du projet examinent et fusionnent ou rejettent votre contribution.
Créer une demande de fusion sur GitLab
Une demande de fusion est identique à une demande d'extraction. La seule différence est leurs noms respectifs.
Pour faire une demande de fusion, vous devez d'abord trouver un projet Hacktoberfest auquel vous souhaitez contribuer. Une fois que vous avez trouvé un projet, cliquez sur le bouton fourche dans le coin supérieur droit :
Forker un projet crée une copie du projet dans votre compte GitLab, vous permettant d'apporter des modifications sans affecter le projet principal. Après avoir forké le projet, clonez le référentiel à partir de votre compte et apportez les modifications à votre environnement de développement local.
Assurez-vous de lire les directives de contribution du projet et de les suivre pour augmenter les chances de votre pull request.
Après avoir apporté les modifications et ajouté votre version dérivée du référentiel, validez les modifications et poussez-les vers GitLab.
Après avoir poussé vos modifications vers GitLab, accédez à votre projet forké et cliquez sur Demandes de fusion dans la barre latérale. Cela fera apparaître un écran expliquant une demande de fusion et un Nouvelle demande de fusion bouton. Clique le Nouvelle demande de fusion bouton, comme indiqué dans l'image ci-dessous.
Ensuite, vous devrez sélectionner un source et cible bifurquer. Le source branch doit être la branche où résident les modifications que vous souhaitez valider dans le référentiel principal. Le cible branch doit être le référentiel principal dans lequel vous souhaitez valider vos modifications. Après avoir sélectionné les branches, cliquez sur le Comparez les succursales et continuez bouton, comme indiqué dans l'image ci-dessous.
En cliquant sur le Comparez les succursales et continuez vous amènera à une page où vous pourrez entrer un titre et une description pour votre demande de fusion.
Remplissez les informations requises et cliquez sur le Créer un bouton de demande de fusion, comme le montre l'image ci-dessous.
Cliquer sur ce bouton crée votre demande de fusion. Vous devez maintenant attendre que les mainteneurs du projet examinent et fusionnent ou ferment votre pull request.
Termes et conditions de Hacktoberfest
Toutes les contributions apportées aux projets du Hacktoberfest doivent être dans les limites du Hacktoberfest et ne pas être du spam. Ne pas suivre les règles du Hacktoberfest peut entraîner la disqualification de l'événement.
Hacktoberfest émet une période d'examen de sept jours pour les demandes d'extraction/fusion qui suivent toutes les directives. Si votre PR est bon, le projet devrait l'accepter pour Hacktoberfest dans ce délai.
Bonne contribution !
