Ce projet vise à simplifier et à guider la manière dont les débutants apportent leur première contribution. Si vous souhaitez apporter votre première contribution, suivez les étapes ci-dessous.
Si vous n'êtes pas à l'aise avec la ligne de commande, voici des tutoriels utilisant les outils GUI.
Forkez ce référentiel en cliquant sur le bouton fork en haut de cette page. Cela créera une copie de ce référentiel dans votre compte.
Clonez maintenant le référentiel forké sur votre machine. Accédez à votre compte GitHub, ouvrez le référentiel forké, cliquez sur le bouton de code, puis cliquez sur l'icône Copier dans le presse-papiers .
Ouvrez un terminal et exécutez la commande git suivante :
git clone "url que vous venez de copier"
où "l'URL que vous venez de copier" (sans les guillemets) est l'URL de ce référentiel (votre fork de ce projet). Voir les étapes précédentes pour obtenir l'url.
Par exemple:
git clone [email protected]:this-is-you/first-contributions.git
où this-is-you est votre nom d'utilisateur GitHub. Ici, vous copiez le contenu du référentiel des premières contributions sur GitHub sur votre ordinateur.
Accédez au répertoire du référentiel sur votre ordinateur (si vous n'y êtes pas déjà) :
cd premières contributions
Créez maintenant une branche à l'aide de la commande git switch :
git switch -c votre-nouvelle-branche-nom
Par exemple:
git switch -c add-alonzo-église
Ouvrez maintenant le fichier Contributors.md dans un éditeur de texte, ajoutez-y votre nom. Ne l'ajoutez pas au début ou à la fin du fichier. Mettez-le n'importe où entre les deux. Maintenant, enregistrez le fichier.
Si vous accédez au répertoire du projet et exécutez la commande git status , vous verrez qu'il y a des changements.
Ajoutez ces modifications à la branche que vous venez de créer à l'aide de la commande git add :
git add Contributeurs.md
Validez maintenant ces modifications à l'aide de la commande git commit :
git commit -m "Ajoutez votre nom à la liste des contributeurs"
en remplaçant your-name par votre nom.
Push vos modifications en utilisant la commande git push :
git push -u origin votre-nom-de-branche
en remplaçant your-branch-name par le nom de la branche que vous avez créée précédemment.
à distance : la prise en charge de l'authentification par mot de passe a été supprimée le 13 août 2021. Veuillez utiliser un jeton d'accès personnel à la place. à distance : veuillez consulter https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ pour plus d'informations. fatal : échec de l'authentification pour 'https://github.com//first-contributions.git/'
Accédez au didacticiel de GitHub sur la génération et la configuration d'une clé SSH pour votre compte.
Si vous accédez à votre référentiel sur GitHub, vous verrez un bouton Compare & pull request . Cliquez sur ce bouton.
Soumettez maintenant la pull request.
Bientôt, je fusionnerai toutes vos modifications dans la branche principale de ce projet. Vous recevrez un e-mail de notification une fois les modifications fusionnées.
Bravo! Vous venez de terminer le workflow standard fork -> clone -> edit -> pull request que vous rencontrerez souvent en tant que contributeur !
Célébrez votre contribution et partagez-la avec vos amis et abonnés en accédant à l'application Web.
Vous pouvez rejoindre notre équipe Slack si vous avez besoin d'aide ou si vous avez des questions. Rejoignez l'équipe Slack.
Commençons maintenant par contribuer à d’autres projets. Nous avons compilé une liste de projets présentant des problèmes simples sur lesquels vous pouvez vous lancer. Consultez la liste des projets dans l'application Web.
Ce projet est soutenu par :
