FirstContribution
1.0.0
C'est dur. C'est toujours difficile la première fois que vous faites quelque chose. Surtout lorsque vous collaborez, faire des erreurs n'est pas une chose confortable. Nous voulions simplifier la façon dont les nouveaux contributeurs open source apprennent et contribuent pour la première fois.
La lecture d'articles et la recherche de tutoriels peuvent aider, mais quoi de mieux que de faire des trucs dans un environnement de pratique? Ce projet vise à fournir des conseils et à simplifier la façon dont les débutants apportent leur première contribution. Si vous cherchez à faire votre première contribution, suivez les étapes ci-dessous.
Si vous n'avez pas de git sur votre machine, installez-le.
Fork ce référentiel en cliquant sur le bouton de la fourche en haut de cette page. Cela créera une copie de ce référentiel dans votre compte.
Clonez maintenant le référentiel fourchu à votre machine. Accédez à votre compte GitHub, ouvrez le référentiel fourchu, cliquez sur le bouton Clone, puis cliquez sur l'icône Copier dans le presse-papiers .
Ouvrez un terminal et exécutez la commande git suivante:
git clone "url you just copied"
où "URL vous venez de copier" (sans les marques de devis) est l'URL de ce référentiel (votre fourche de ce projet). Voir les étapes précédentes pour obtenir l'URL.
Par exemple:
git clone https://github.com/this-is-you/FirstContribution.git
où this-is-you votre nom d'utilisateur github. Ici, vous copiez le contenu du référentiel FirstContribution sur GitHub sur votre ordinateur.
Passez au répertoire du référentiel sur votre ordinateur (si vous n'êtes pas déjà là):
cd FirstContribution
Créez maintenant une branche à l'aide de la commande git checkout :
git checkout -b <add-your-new-branch-name>
Par exemple:
git checkout -b add-alonzo-church
(Le nom de la branche n'a pas besoin de faire l' ajouter le mot, mais c'est une chose raisonnable à inclure car le but de cette branche est d'ajouter votre nom à une liste.)
Maintenant, ouvrez Contributors.md Fichier dans un éditeur de texte, ajoutez-y votre nom. Maintenant, enregistrez le fichier.
Si vous accédez au répertoire du projet et exécutez l' git status , vous verrez qu'il y a des modifications.
Ajoutez ces modifications à la branche que vous venez de créer à l'aide de la commande git add :
git add Contributors.md
Commissez maintenant ces modifications en utilisant la commande git commit :
git commit -m "Add <your-name> to Contributors list"
Remplacement <your-name> par votre nom.
Poussez vos modifications en utilisant la commande git push :
git push origin <add-your-branch-name>
Remplacement <add-your-branch-name> par le nom de la branche que vous avez créé plus tôt.
Si vous accédez à votre référentiel sur GitHub, vous verrez un bouton Compare & pull request . Cliquez sur ce bouton.
Soumettez maintenant la demande de traction.
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 la fourche standard -> clone -> edit -> workflow PR que vous rencontrerez souvent en tant que contributeur!
Vous pourriez rejoindre notre équipe Slack au cas où vous auriez besoin d'aide ou que vous ayez des questions à rejoindre l'équipe Slack.
