🚀 Learn GitHub

Welcome to the ultimate GitHub learning guide.
This README is designed so that anyone can learn Git + GitHub from zero to advanced, simply by reading it.

• Clear explanations
• Examples
• Diagrams
• Tables
• Best practices
• Advanced concepts
• Real workflows

---

📘 What Are Git & GitHub?

🔧 What is Git?

Git is a distributed version control system (VCS). It helps developers:

• Track changes in code
• Restore previous versions
• Work on features safely
• Collaborate without overwriting code

Think of Git as a time-machine + teamwork tool for code.

💻 What is GitHub?

GitHub is an online platform built on top of Git. It provides:

• Cloud hosting for repositories
• Collaboration tools
• Automation (CI/CD)
• Project management
• Documentation hosting

Git = Version control
GitHub = Social network + cloud for Git projects

---

🛠 Installing & Configuring Git

Step 1: Install Git

Download Git from: https://git-scm.com/downloads

git --version

Step 2: Configure Git (Required)

git config --global user.name "Your Name"
git config --global user.email "your@email.com"

---

📁 Repositories — Local & Remote

A repository (repo) is a folder tracked by Git.

Two types:

• Local repository (on your computer)
• Remote repository (on GitHub)

Create a Local Repository

mkdir my-project
cd my-project
git init

Create a Remote Repository (GitHub)

1. Log in → Click New Repository
2. Enter a name
3. Click Create

Link Local → GitHub

git remote add origin https://github.com/username/repo.git
git push -u origin main

---

📄 Understanding Git Workflow

Diagram: Local → GitHub Workflow

A[Working Directory] → git add → Staging Area → git commit → Local Repo → git push → GitHub Remote Repo

---

🧱 Essential Git Commands

Command	Purpose
git init	Start a new repo
git clone	Copy a GitHub repo
git add	Stage changes
git commit	Save changes
git status	Show file states
git push	Upload to GitHub
git pull	Download from GitHub
git log	Show commit history

---

🔁 Commit, Push & Pull (Core Git Flow)

git add .
git commit -m "Describe what you changed"
git push origin main
git pull origin main

---

🌿 Branching — Safe Way to Build Features

Create a branch

git checkout -b login-feature

Switch branches

git checkout main

Merge branch

git merge login-feature

Delete branch

git branch -d login-feature

---

📥 Pull Requests (PRs) — Collaboration Workflow

Pull Requests allow:

• Reviewing code
• Discussing changes
• Running automated tests
• Merging feature branches

1. Push your branch
2. Go to Pull Requests
3. Click New Pull Request
4. Write title & description
5. Add reviewers
6. Submit

---

🤝 Collaboration — Forks & Clones

Clone a repo

git clone https://github.com/user/repo.git

Forking

Fork = Copy someone’s repo into your GitHub

Add upstream (original repo)

git remote add upstream https://github.com/original/repo.git

Sync fork

git fetch upstream
git merge upstream/main

---

💼 Issues, Labels, & Milestones

Issues Used For

• Bugs 🐞
• Feature requests ✨
• Questions ❓
• Tasks 📌

Labels

Label	Meaning
bug	Something not working
enhancement	New feature
documentation	Docs needed
good-first-issue	Beginner friendly

---

🧪 GitHub Actions — Automation & CI/CD

Example Workflow

name: CI
on: [push]

jobs:
 build:
  runs-on: ubuntu-latest
  steps:
   - uses: actions/checkout@v2
   - name: Install Packages
     run: npm install
   - name: Run Tests
     run: npm test

---

🌐 GitHub Pages — FREE Website Hosting

1. Go to Settings → Pages
2. Select a branch
3. Save

Your website will appear at:

https://username.github.io/repository-name

---

🧠 Advanced Git Concepts

Soft Reset (keep changes)

git reset --soft HEAD~1

Hard Reset (delete changes)

git reset --hard HEAD~1

Stash (temporary save)

git stash
git stash list
git stash pop

Rebase

git rebase main

Cherry-pick

git cherry-pick <commit-id>

Tags

git tag v1.0.0
git push origin v1.0.0

---

🚨 Best Practices Every Developer Should Follow

• Commit small & frequently
• Write meaningful commit messages
• Use branches for each feature
• Use PRs & request reviews
• Keep main always stable
• Automate tests with GitHub Actions
• Document everything

---

📚 Useful Resources

• Git Documentation
• GitHub Docs
• GitHub Actions Docs
• GitHub Pages Docs

---

Happy Coding! ✨👨‍💻👩‍💻