OpenSource101
1.0.0
Il s'agit d'un référentiel de démarrage spécialement réalisé afin que nous puissions vous aider à obtenir votre première demande de traction et à apprendre les bases de Git et Github.
Si vous êtes un débutant et que vous êtes venu chercher votre première contribution, nous sommes là pour vous aider.
Nous avons fourni les instructions pour que vous commenciez à contribuer à l'open source. Faites défiler vers le bas pour plus d'informations.
Tout d'abord, installez GIT sur votre système local. Si vous êtes sur Linux ou Mac, vous obtenez un préinstallé GIT.
Cependant, si vous êtes sous Windows, vous devrez l'installer. Pour ce faire, cliquez ici.
Rendez-vous sur github.com et créez un compte en vous inscrivant.
L'approvisionnement ouvert et la contribution à Internet gratuit sont ce qui motive Internet aujourd'hui, et tout le monde et chaque contribution sont appréciés dans le monde open source.
Et, vous pouvez vous joindre à nous avec votre première demande de traction ici!
Vous pouvez mettre en vedette et alimenter ce référentiel sur GitHub en haut du référentiel.
Forking vous permet de créer une version du référentiel pour vous-même.
Cela vous permet d'apporter des modifications au référentiel sans nécessiter aucune autorisation ou interférer avec le référentiel existant.
Maintenant, redirigez-vous vers votre fourche du référentiel, qui devrait avoir une URL comme ainsi,
https://github.com/your-github-username/openSource101
Pour faire votre propre copie du référentiel auquel vous souhaitez contribuer, vous devrez le cloner vers votre système pour un accès plus facile. En utilisant le git clone Commmand, vous pouvez cloner le référentiel de votre système local. Alors que l'URL serait essentiellement comme,
https://github.com/your-username/openseource101.git
Il est plus facile de simplement cliquer sur l'icône du clone et de le copier dans votre presse-papiers.
Après quoi, vous dirigez simplement à l'endroit où vous souhaitez cloner le référentiel pour utiliser le répertoire de changement ou la commande cd dans Terminal, puis git clone votre projet.
Dirigez-vous dans le référentiel à l'aide cd OpenSource101/ . Maintenant, nous allons créer et passer à la branche sur laquelle nous travaillerons, pour l'édition de fichiers dans le projet.
Créer une branche,
git branch branch-name
Passer de la branche principale à une autre branche,
git checkout branch-name
Affichage de toutes les branches disponibles pour votre référentiel,
git branch -a
Pour faciliter la contribution, nous avons fait un modèle fixe sur lequel vous pouvez travailler. Suivez les étapes ci-dessous.
Nous pouvons enfin arriver à contribuer au référentiel maintenant!
Maintenant que vous êtes passé à une autre branche, modifiez votre répertoire en contributors à l'aide cd contributors .
Créez un fichier avec votre nom d'utilisateur GitHub avec une extension .json .
Exemple: github-username.json , où github-username est votre nom d'utilisateur GitHub actuel.
Le contenu du fichier JSON dans le format ci-dessous,
{
"github-username" : " YOUR-GITHUB-USERNAME " ,
"favourite-game" : " YOUR-FAVOURITE-GAME " ,
"favourite-language" : " YOUR-FAVOURITE-PROGRAMMING-LANGUAGE " ,
"favourite-color" : " #FFFFFF "
} "github-username" should be the same one as the one you're making the pull request from.
"favourite-game" can be any game that you really like.
"favourite-language" has to be your favourite programming language or any programming language that you really want to learn.
"favourite-color" can be any color in hex format (example: #FFF44F). You can pick any color from Google's color picker.
Remarque : assurez-vous que vos contributions sont conformes à notre code de conduite.
Vous pouvez ajouter tous les fichiers que vous avez mis à jour à l'aide de la commande git add -A
Ensuite, vous vous engagez à enregistrer les fichiers, comme vous le feriez à un point de contrôle, git commit -m "added myself"
Maintenant, vous voulez pousser à votre fourchette en ligne, qui fonctionne avec git push origin branch-name .
Il est important de maintenir votre référentiel local à jour avec le projet afin d'éviter la fusion des conflits. Pour ce faire, vous devrez configurer une télécommande pour la fourche, puis synchroniser la fourche.
Afin de créer une télécommande pour la fourche, vous devrez spécifier un nouveau repoingyre en amont à distance (le référentiel à partir duquel vous avez fourré) à la synchronisation avec la fourche. Vous utiliserez la commande git remote add pour le faire.
git distant ajouter en amont https://github.com/open-source-communnity-vit-ap/openseource101.git
Remarque : nous avons référencé le référentiel d'origine comme "en amont".
Une fois que la télécommande fait référence au référentiel d'origine dont vous avez fourré, vous êtes prêt à synchroniser les modifications afin de maintenir votre copie locale à jour. Pour ce faire, nous utilisons la commande git fetch .
git chercher en amont
Une fois terminé, vous devez revenir à la branche principale, vous pouvez le faire en utilisant
Git Checkout Main
Maintenant, fusionnez les modifications apportées à la branche principale du référentiel d'origine avec votre branche principale locale actuelle en utilisant
Git fusionne en amont / principal
Une fois votre référentiel local mis à jour, vous êtes prêt à nous envoyer une demande de traction.
Pour ce faire, ouvrez simplement votre référentiel fourchu et cliquez sur la demande de traction, vous pouvez maintenant voir un bouton vert qui dit "nouvelle demande de pull".
Créez la demande de traction et détendez-vous et détendez-vous jusqu'à ce que vous receviez un avis signifiant l'acceptation de votre demande de traction ou la demande de modification de vos modifications.
Remarque : Si vous avez une question concernant l'une des étapes ci-dessus ou sur tout ce qui concerne ce référentiel, créez simplement un problème.
Maintenant, que vous avez fait votre première demande de traction, il est temps d'explorer le vaste réseau open source, rempli de projets qui ont un potentiel révolutionnaire.
Des projets qui peuvent révolutionner la façon dont nous regardons les choses.
En plus de créer le vôtre pour que d'autres personnes puissent apprécier et contribuer!
