How to Contribute to a GitHub Repository 🚀

GitHub is a platform that allows you to collaborate with other developers on projects using version control and code hosting. Whether you are the owner of a repository or a contributor, you need to follow some steps to make sure your work is synced and updated with the main branch. Here is a guide on how to do that using Git commands.

For Owners 👑

As an owner of a repository, you have full control over the project and can manage the access and permissions of other contributors. You can also create branches, merge pull requests and push changes to the main branch. Here are the steps you need to follow as an owner:

Step 1: Fork the Repository 🍴

Forking a repository means creating a copy of it on your GitHub account. This allows you to make changes to the project without affecting the original source. To fork a repository, go to its page on GitHub and click on the Fork button at the top right corner. You will see a message saying that the repository is being forked. Once it is done, you will have your own copy of the repository on your account.

Step 2: Clone the Repository 📥

Cloning a repository means downloading it to your local machine so that you can work on it offline. To clone a repository, you need to use the git clone command followed by the URL of the repository. You can find the URL by clicking on the Code button on your forked repository page and copying the HTTPS link. For example:

git clone https://github.com/your-username/xamtrack.git

This will create a folder called xamtrack on your current directory with all the files and folders of the repository.

Step 3: Create a Branch 🌿

A branch is a separate version of the repository that allows you to work on different features or bug fixes without affecting the main branch. To create a branch, you need to use the git branch command followed by the name of the branch. For example:

git branch new-feature

This will create a new branch called new-feature but it will not switch to it. To switch to a branch, you need to use the git checkout command followed by the name of the branch. For example:

git checkout new-feature

This will switch to the new-feature branch and update your working directory accordingly.

Step 4: Check Your Status 🔎

To see what files have been changed or added in your working directory, you can use the git status command. This will show you which files are staged (ready to be committed), modified (changed but not staged) or untracked (new files that are not tracked by Git). For example:

git status

This will show something like this:

On branch new-feature

Changes not staged for commit:

  (use "git add <file>..." to update what will be committed)

  (use "git restore <file>..." to discard changes in working directory)

        modified:   README.md



Untracked files:

  (use "git add <file>..." to include in what will be committed)

        new-file.txt



no changes added to commit (use "git add" and/or "git commit -a")

Step 5: Add Your Changes ➕

To stage your changes for committing, you need to use the git add command followed by the name of the file or folder. For example:

git add README.md

This will add the modified README.md file to the staging area. You can also use . (dot) as a shortcut to add all the files in your working directory. For example:

git add .

This will add all the modified and untracked files to the staging area.

Step 6: Commit Your Changes 💾

To save your changes in your local repository, you need to use the git commit command followed by a message that describes what you have done. For example:

git commit -m "Added new feature"

This will create a new commit with the message "Added new feature" and include all the files that are staged.

Step 7: Push Your Changes 🚀

To upload your changes to your remote repository on GitHub, you need to use the git push command followed by the name of your branch. For example:

git push origin new-feature

This will push your new-feature branch to your forked repository on GitHub. You can also use -u (upstream) as a shortcut to set the remote branch as the default for your local branch. For example:

git push -u origin new-feature

This will push your new-feature branch and set it to track the remote branch.

Step 8: Pull Request 🙏

A pull request is a way of requesting the owner of the original repository to review and merge your changes into the main branch. To create a pull request, you need to go to your forked repository page on GitHub and click on the Pull request button. You will see a page where you can compare your branch with the main branch and write a title and a description for your pull request. For example:

Once you are done, click on the Create pull request button. This will send a notification to the owner of the original repository and they can review your changes and decide whether to accept them or not.

Congratulations! 🎉 You have successfully contributed to a GitHub repository! 🙌

CheatSheet 📝

For the owner of the repository:

1. 
   Fork the repository.🍴


2. 
   Clone the repository to your local machine.💻


3. Create a new branch by typing git branch your_branch_name.🌿


4. 
   Switch to your new branch by typing git checkout your_branch_name.🔀


5. Check the status of your changes by typing git status.🔍


6. 
   Add your changes by typing git add .
   


7. 
   Commit your changes by typing git commit -m "your changes".💬


8. 
   Push your changes to the remote repository by typing git push origin your_branch_name.🚀


9. Create a pull request by typing git pull origin main_branch_name.📬

💡Tip: You can use git commit without the -m flag to open a text editor where you can write a more detailed commit message.

For contributors:

1. 
   Fork the repository and clone it to your local machine.🍴💻


2. Add an upstream link to the main branch in your cloned repository by typing git remote add upstream https://github.com/Subham-Maity/xamtrack.git.🔗


3. Keep your cloned repository up-to-date by pulling from upstream by typing git pull upstream main.🔄


4. Create a new feature branch by typing git checkout -b <feature-name>.🌿


5. 
   Add your changes by typing git add .
   


6. 
   Commit all your changes with a meaningful message by typing git commit -m "Write a meaningful but small commit message".💬


7. 
   Push your changes for review by typing git push origin <branch-name>.🚀


8. Create a pull request (PR) on GitHub with a clear message explaining why and what you are contributing.📬