91 lines
5.5 KiB
Markdown
91 lines
5.5 KiB
Markdown
---
|
|
title: Create a repo
|
|
redirect_from:
|
|
- /create-a-repo/
|
|
- /articles/create-a-repo
|
|
- /github/getting-started-with-github/create-a-repo
|
|
- /github/getting-started-with-github/quickstart/create-a-repo
|
|
intro: 'To put your project up on {% data variables.product.product_location %}, you''ll need to create a repository for it to live in.'
|
|
versions:
|
|
free-pro-team: '*'
|
|
enterprise-server: '*'
|
|
github-ae: '*'
|
|
topics:
|
|
- Pull requests
|
|
- Issues
|
|
- Notifications
|
|
- Accounts
|
|
---
|
|
## Create a repository
|
|
|
|
{% if currentVersion == "free-pro-team@latest" %}
|
|
|
|
You can store a variety of projects in {% data variables.product.product_name %} repositories, including open source projects. With [open source projects](http://opensource.org/about), you can share code to make better, more reliable software. You can use repositories to collaborate with others and track your work. For more information, see "[About repositories](/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/about-repositories)."
|
|
|
|
{% elsif enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %}
|
|
|
|
You can store a variety of projects in {% data variables.product.product_name %} repositories, including innersource projects. With innersource, you can share code to make better, more reliable software. For more information on innersource, see {% data variables.product.company_short %}'s white paper "[An introduction to innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)."
|
|
|
|
{% endif %}
|
|
|
|
{% if currentVersion == "free-pro-team@latest" %}
|
|
|
|
{% note %}
|
|
|
|
**Note:** You can create public repositories for an open source project. When creating your public repository, make sure to include a [license file](https://choosealicense.com/) that determines how you want your project to be shared with others. {% data reusables.open-source.open-source-guide-repositories %} {% data reusables.open-source.open-source-learning-lab %}
|
|
|
|
{% endnote %}
|
|
|
|
{% endif %}
|
|
|
|
{% data reusables.repositories.create_new %}
|
|
2. Type a short, memorable name for your repository. For example, "hello-world".
|
|
|
|
3. Optionally, add a description of your repository. For example, "My first repository on {% data variables.product.product_name %}."
|
|
|
|
{% data reusables.repositories.choose-repo-visibility %}
|
|
{% data reusables.repositories.initialize-with-readme %}
|
|
{% data reusables.repositories.create-repo %}
|
|
|
|
Congratulations! You've successfully created your first repository, and initialized it with a *README* file.
|
|
|
|
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %}
|
|
{% tip %}
|
|
|
|
**Tip**: You can also create repositories using the {% data variables.product.prodname_cli %}. For more information, see "[`gh repo create`](https://cli.github.com/manual/gh_repo_create)" in the {% data variables.product.prodname_cli %} documentation.
|
|
|
|
{% endtip %}
|
|
{% endif %}
|
|
|
|
## Commit your first change
|
|
|
|
A *[commit](/articles/github-glossary#commit)* is like a snapshot of all the files in your project at a particular point in time.
|
|
|
|
When you created your new repository, you initialized it with a *README* file. *README* files are a great place to describe your project in more detail, or add some documentation such as how to install or use your project. The contents of your *README* file are automatically shown on the front page of your repository.
|
|
|
|
Let's commit a change to the *README* file.
|
|
|
|
1. In your repository's list of files, click ***README.md***.
|
|
|
|
2. Above the file's content, click {% octicon "pencil" aria-label="The edit icon" %}.
|
|
3. On the **Edit file** tab, type some information about yourself.
|
|
|
|
{% data reusables.files.preview_change %}
|
|
5. Review the changes you made to the file. You'll see the new content in green.
|
|
|
|
{% data reusables.files.write_commit_message %}
|
|
{% data reusables.files.choose_commit_branch %}
|
|
{% data reusables.files.propose_file_change %}
|
|
|
|
## Celebrate
|
|
|
|
Congratulations! You have now created a repository, including a *README* file, and created your first commit on {% data variables.product.product_location %}.
|
|
|
|
You can now clone a {% data variables.product.product_name %} repository to create a local copy on your computer. From your local repository you can commit, and create a pull request to update the changes in the upstream repository. For more information, see "[Cloning a repository](/github/creating-cloning-and-archiving-repositories/cloning-a-repository)" and "[Set up Git](/articles/set-up-git)."
|
|
|
|
You can find interesting projects and repositories on {% data variables.product.product_name %} and make changes to them by creating a fork of the repository. For more information see, "[Fork a repository](/articles/fork-a-repo)."
|
|
|
|
Each repository in {% data variables.product.product_name %} is owned by a person or an organization. You can interact with the people, repositories, and organizations by connecting and following them on {% data variables.product.product_name %}. For more information see "[Be social](/articles/be-social)."
|
|
|
|
{% data reusables.support.connect-in-the-forum-bootcamp %}
|