================================================================================
GITHUB USAGE GUIDE
How to Use GitHub Online, From CLI, and GitKraken
================================================================================
TABLE OF CONTENTS
-----------------
1. Introduction
2. Using GitHub Online
3. Using GitHub CLI
4. Using GitKraken
================================================================================
1. INTRODUCTION
================================================================================
This guide will teach you how to efficiently use GitHub through its online
platform, command-line interface (CLI), and GitKraken GUI tool. Learn how to
upload, download, and sync code to ensure consistency across your projects.
================================================================================
2. USING GITHUB ONLINE
================================================================================
### Uploading Changes
1. Sign in to GitHub and navigate to your repository.
2. Click on "Add file" or navigate to a directory and click on the "Upload files"
button.
3. Drag and drop files or select files to upload from your computer.
4. Commit the changes with a descriptive message and click "Commit changes."
### Downloading Changes
1. Sign in to GitHub and navigate to your repository.
2. Click on "Code" and then "Download ZIP" to download the entire repository.
3. For specific files, navigate to the file, click on the file name, and then
"Download."
### Syncing Changes
1. Go to your repository and review all changes made by collaborators.
2. Use "Compare & pull request" to merge changes from one branch to another.
3. Confirm merge after reviewing comparison and changes successfully.
4. Use "Contributors" tab to review updates and contributions from others.
================================================================================
3. USING GITHUB CLI
================================================================================
### Installation
Install GitHub CLI following instructions for [GitHub CLI
installation](https://github.com/cli/cli#installation).
### Authenticating
```bash
gh auth login
```
### Uploading Changes
1. Initialize your repository (if not done already)
```bash
git init
git add .
git commit -m "[description]"
```
2. Create a GitHub repository:
```bash
gh repo create <repository-name> --public
git push -u origin main
```
### Downloading Changes
1. Clone a repository:
```bash
gh repo clone <owner>/<repo>
```
2. Pull updates:
```bash
git pull origin main
```
### Syncing Changes
1. Fetch latest changes:
```bash
git fetch
```
2. Review differences:
```bash
git diff
```
3. Merge changes:
```bash
git merge origin/main
```
4. Solve conflicts (if any) and push:
```bash
git add .
git commit -m 'resolve conflicts'
git push
```
================================================================================
4. USING GITKRAKEN
================================================================================
### Installation
Download and install [GitKraken](https://www.gitkraken.com/).
### Authenticating
1. Open GitKraken and sign in with GitHub credentials.
2. Authorize GitKraken to access your GitHub account.
### Uploading Changes
1. Open the repository in GitKraken.
2. Stage your changes by dragging files to the "Staged Files" area.
3. Write a commit message and click "Commit changes."
4. Click the "Push" button to push changes to GitHub.
### Downloading Changes
1. Fetch latest changes by clicking the "Fetch" button.
2. Pull changes by clicking the "Pull" button.
3. Alternatively, right-click on remote branches and select "Checkout" or "Pull."
### Syncing Changes
1. Use the "Remotes" pane to view remote branches.
2. Drag changes from other branches into yours for merge.
3. Resolve conflicts in the visual interface and commit updates.
4. Push final changes after resolving differences.
================================================================================
END OF GUIDE
================================================================================
For further assistance, consult official GitHub, GitHub CLI, and GitKraken
documentation.
