What is a GitHub repository, and how to create and manage the first one?

[renysrs]

I often hear the term "repository" but don’t understand its specific function or how to create my first one. I want to learn about the core functions of a repository (such as storing code, version control), key settings during creation (e.g., public or private, adding a README file), and basic management operations like uploading and modifying files after creation.

[gablsl]

A GitHub repository is like a folder where you store all the files for a project. It’s a place where you keep your code, images, documents, and anything related to your project.

GitHub helps you keep track of changes to your files, so if you mess something up, you can go back to earlier versions. It’s also a great way to share your project with other people.

How to Create Your First Repository on GitHub:

Click the + in the top-right corner and choose New repository.

Name your repo: Pick a name for your project (like "To do Project").

Description (optional): You can write a short description, like “This is my to-do project.”

Public or Private: If you want everyone to see it, choose Public. If you want it to be private (only you can see it), choose Private.

Add a README: Check the box that says “Add a README file” – this is where you can write a little about your project.

Click Create Repository: After filling it out, click Create repository. You’re done!

How to Manage Your Repository:

Now that your repo is created, here’s what you can do:

1. Upload Files:

Go to your repo’s page and click Upload files.

Drag and drop your files (like code or images) into the box.

Once uploaded, click Commit changes to save them.

2. Edit Files:

To change a file, click on it and hit the pencil icon to edit.

After editing, click Commit changes to save your changes.

3. Create a Branch (Optional):

A branch lets you make changes without affecting the main version of your project. If you’re working on something new, you can create a branch to try it out, then merge it back into the main project if it works.

4. Clone Your Repo (Optional):

Cloning means copying your repo to your computer so you can work on it locally. You can use a program like GitHub Desktop to do this.

[sheikhbadar]

A repository is just a project folder on GitHub where you keep your code and files. It lets you track changes (version control) and share work with others.
• To create one: click New repository, give it a name, choose Public or Private, and add a README.
• After that, you can upload files, edit them, or create new ones directly in the repo.