02 — Creating a repository

A repository is one project. Create one per project, not one per file.

Steps

1. Press + at the top right → New Repository.
2. Owner — yourself, or an organisation you belong to.
3. Repository name — lowercase, no spaces: network-lab, web-site, guide.
4. Description — one line explaining what it is. It appears in search results.
5. Visibility
• Public — anyone who can reach the server can read it.
• Private — only you and the people you invite.
6. Initialize repository — tick it. This creates the first commit with a README.md, so the repository is usable straight away.
7. Press Create Repository.

Good names

Spaces and brackets in names make links harder to share and can confuse relative paths inside documents. Lowercase letters, digits and hyphens are always safe.

After creation

• Settings → Collaborators — give other people read or write access.
• Settings → Branches — protect main so nobody commits to it directly.
• Add File — start filling the repository (chapter 03).

Deleting a repository

Settings → Danger Zone → Delete this repository. You must type the repository name to confirm. This cannot be undone — the history goes with it.