What is GitHub?

GitHub is a web-based platform that uses Git for version control, providing:

• Code hosting
• Collaboration tools
• Project management features
• Social networking for developers

Key GitHub Concepts

1. Repositories

• Digital project storage spaces
• Can be public (visible to everyone) or private
• Contain:
  • Project files
  • Version history
  • Documentation
  • Project settings

2. Key Features

Repository Components

• README.md: Project overview and instructions
• .gitignore: Specifies intentionally untracked files
• LICENSE: Defines how others can use your project
• CONTRIBUTING.md: Guidelines for contributors

Collaboration Tools

• Issues: Track bugs, enhancements, tasks
• Pull Requests: Propose changes to repositories
• Projects: Kanban-style project management
• Wiki: Detailed project documentation

3. GitHub Workflow

1. Fork Repository
2. Clone to Local Machine
3. Create Branch
4. Make Changes
5. Commit Changes
6. Push to Your Fork
7. Create Pull Request
8. Collaborate and Merge

Getting Started

Create a GitHub Account

1. Visit github.com
2. Click “Sign Up”
3. Choose free plan
4. Complete profile setup

Creating Your First Repository

Method 1: Direct on GitHub

1. Click “+” icon in top-right
2. Select “New Repository”
3. Name your repository
4. Choose public or private
5. Optionally add README, .gitignore, LICENSE
6. Click “Create Repository”

Method 2: From Local Machine

1. Create local project folder
2. Initialize Git
3. Add remote repository

# Initialize local git
git init

# Connect to GitHub
git remote add origin https://github.com/yourusername/repository-name.git

# First push
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main

Essential GitHub Features

1. Issues

• Report bugs
• Request features
• Discuss project improvements
• Assign team members
• Add labels and milestones

2. Pull Requests

• Propose changes to a repository
• Enable code review
• Discuss modifications
• Merge approved changes

3. Actions (Automation)

• Continuous Integration/Continuous Deployment (CI/CD)
• Automated testing
• Build and deploy workflows
• Schedule recurring tasks

4. GitHub Pages

• Free hosting for static websites
• Directly from repository
• Great for project documentation
• Support for Jekyll, HTML, CSS, JavaScript

Best Practices

1. Commit Etiquette
   • Write clear, descriptive commit messages
   • Make small, focused commits
   • Include context in descriptions
2. Repository Management
   • Keep README updated
   • Use meaningful branch names
   • Protect main branch
   • Write good documentation
3. Collaboration
   • Respond to issues promptly
   • Review pull requests carefully
   • Be respectful and constructive
   • Follow project contribution guidelines

Security and Privacy

• Two-factor authentication
• Personal access tokens
• Manage repository visibility
• Vulnerability alerts
• Security advisories

Learning Resources

• GitHub Docs
• GitHub Learning Lab
• YouTube Tutorials
• Udemy/Coursera Courses

Pro Tips

• Star repositories you like
• Follow developers in your field
• Contribute to open-source projects
• Build a portfolio of projects
• Network with other developers

---

GitHub: The Developer’s Collaborative Platform

Essential Git and GitHub Commands

Local Repository Commands

Repository Initialization

• git init: Create a new local Git repository
• git clone [url]: Copy an existing repository from remote source
  • Example: git clone https://github.com/username/repository.git

Basic Configuration

• git config --global user.name "Your Name": Set your name
• git config --global user.email "[email protected]": Set your email
• git config --list: View current configuration

Checking Status and Changes

• git status: Show status of changes
• git diff: Show file differences not yet staged
• git diff --staged: Show differences between staging and last commit

Staging and Committing

• git add [file]: Stage specific file
• git add .: Stage all changed files
• git commit -m "Commit message": Commit staged changes
• git commit -am "Commit message": Stage and commit modified files
• git reset [file]: Unstage a file
• git reset --hard HEAD: Discard all local changes

Branch Management

• git branch: List branches
• git branch [branch-name]: Create new branch
• git checkout [branch-name]: Switch to a branch
• git checkout -b [branch-name]: Create and switch to new branch
• git merge [branch]: Merge branch into current branch
• git branch -d [branch-name]: Delete a branch
• git branch -D [branch-name]: Force delete a branch

Remote Repository Interactions

• git remote add origin [url]: Connect local repo to remote
• git remote -v: List remote repositories
• git push origin [branch]: Upload branch to remote
• git push -u origin [branch]: Push and set upstream
• git pull origin [branch]: Download and merge remote changes
• git fetch: Download remote content without merging

Logging and History

• git log: View commit history
• git log --oneline: Compact commit history
• git log -n [number]: View last n commits
• git blame [file]: Show who changed what and when in a file

Undoing Changes

• git revert [commit]: Create new commit that undoes a previous commit
• git reset [commit]: Move back to a previous commit
• git checkout -- [file]: Discard changes in working directory
• git stash: Temporarily store modified files
• git stash pop: Reapply stashed changes

GitHub-Specific Workflows

Forking a Repository

1. Click “Fork” button on GitHub repository page
2. Choose where to fork the repository

Creating Pull Requests

1. Fork the original repository
2. Clone your forked repository
3. Create a new branch
4. Make changes
5. Push changes to your fork
6. Click “New Pull Request” on original repository

Managing Issues

• Create issues directly on GitHub repository
• Use keywords in commit messages to close issues
  • Fixes #issue-number
  • Closes #issue-number
  • Resolves #issue-number

Advanced Git Commands

Rebasing

• git rebase [branch]: Reapply commits on top of another base
• git rebase -i [commit]: Interactive rebase

Tagging

• git tag [tagname]: Create a lightweight tag
• git tag -a [tagname] -m "Tag message": Create annotated tag
• git push origin [tagname]: Push specific tag
• git push --tags: Push all tags

GitHub CLI Commands

• gh repo create: Create a new repository
• gh issue create: Create a new issue
• gh pr create: Create a pull request
• gh repo view: View repository details
• gh repo clone [repository]: Clone a repository

Best Practices

• Use meaningful branch and commit names
• Write descriptive commit messages
• Keep commits small and focused
• Use pull requests for code review
• Protect your main branch
• Use .gitignore to exclude unnecessary files

Recommended Tools

• GitHub Desktop
• VS Code Git Integration
• GitKraken
• Sourcetree

Learning Resources

• Official Git Documentation
• GitHub Learning Lab
• Udemy/Coursera Git Courses
• YouTube Tutorials