Frequently Asked Question

How Do I Create My First GitHub Repository?
Last Updated about a month ago

image


A GitHub repository (often called a "repo") is a folder that stores your project files, documentation, screenshots, and other resources. Repositories allow you to organize your work and make it easy to share with employers, instructors, and other professionals.

Step 1: Sign In to GitHub

Visit GitHub and sign in to your account. If you do not have an account, create one using your preferred email address.

Step 2: Create a New Repository

  1. Click the + icon in the upper-right corner.
  2. Select New Repository.
  3. Enter a repository name that clearly describes your project.

Examples:

  • Fedora-Firewall-Monitoring
  • Linux-Administration-Labs
  • PSChi02-Helpdesk
  • Active-Directory-Lab

Step 3: Add a Description

Provide a brief summary of the project.

Example:

A monitoring solution built using Fedora Linux, Prometheus, Grafana, and Node Exporter to track system performance and service health.

Step 4: Create a README File

Check the option to create a README file. This file acts as the front page of your project and explains what the project is about.

Step 5: Organize Your Repository

Create folders for:

  • Documentation
  • Screenshots
  • Troubleshooting Guides
  • Configuration Files (if applicable)

Step 6: Upload Your Project Files

Add screenshots, notes, documentation, diagrams, and other project materials to the repository.

Step 7: Keep It Updated

As you continue working on the project:

  • Add new documentation
  • Upload additional screenshots
  • Record lessons learned
  • Document troubleshooting steps
  • Update project milestones

Best Practice

Create one repository for each major project rather than placing all projects into a single repository. This makes your work easier to navigate and demonstrates organization skills to potential employers.

Key Takeaway

A repository is more than just storage for files—it is a professional record of your work, learning, and problem-solving abilities. Properly maintained repositories can become powerful additions to your resume and portfolio.

Please Wait!

Please wait... it will take a second!