From c2bcee148ef3226c73b8175cbd1b9ac2798bc6db Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Wed, 13 Dec 2023 13:18:44 -0700 Subject: [PATCH] [Improvement]: Get started (phase 1): Moving "Create a repo" from Quickstart to Repositories (#47448) Co-authored-by: Anne-Marie <102995847+am-stead@users.noreply.github.com> --- content/get-started/quickstart/github-flow.md | 2 +- content/get-started/quickstart/index.md | 1 - content/get-started/quickstart/set-up-git.md | 2 +- content/github-cli/index.md | 2 +- .../about-repositories.md | 2 +- .../index.md | 1 + .../quickstart-for-repositories.md} | 29 ++++--------------- content/repositories/index.md | 2 +- .../getting-started/create-a-repository.md | 2 +- 9 files changed, 12 insertions(+), 31 deletions(-) rename content/{get-started/quickstart/create-a-repo.md => repositories/creating-and-managing-repositories/quickstart-for-repositories.md} (75%) diff --git a/content/get-started/quickstart/github-flow.md b/content/get-started/quickstart/github-flow.md index fed42a111759..3d6a943855f4 100644 --- a/content/get-started/quickstart/github-flow.md +++ b/content/get-started/quickstart/github-flow.md @@ -23,7 +23,7 @@ topics: ## Prerequisites -To follow {% data variables.product.prodname_dotcom %} flow, you will need a {% data variables.product.prodname_dotcom %} account and a repository. {% ifversion fpt or ghec %}For information on how to create an account, see "[AUTOTITLE](/get-started/quickstart/creating-an-account-on-github)."{% elsif ghes or ghae %}For more information, contact your site administrator.{% endif %} For information on how to create a repository, see "[AUTOTITLE](/get-started/quickstart/create-a-repo)."{% ifversion fpt or ghec %} For information on how to find an existing repository to contribute to, see "[AUTOTITLE](/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github)."{% endif %} +To follow {% data variables.product.prodname_dotcom %} flow, you will need a {% data variables.product.prodname_dotcom %} account and a repository. {% ifversion fpt or ghec %}For information on how to create an account, see "[AUTOTITLE](/get-started/quickstart/creating-an-account-on-github)."{% elsif ghes or ghae %}For more information, contact your site administrator.{% endif %} For information on how to create a repository, see "[AUTOTITLE](/repositories/creating-and-managing-repositories/quickstart-for-repositories)."{% ifversion fpt or ghec %} For information on how to find an existing repository to contribute to, see "[AUTOTITLE](/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github)."{% endif %} ## Following {% data variables.product.prodname_dotcom %} flow diff --git a/content/get-started/quickstart/index.md b/content/get-started/quickstart/index.md index 48d1917428a5..f715bbd20b7f 100644 --- a/content/get-started/quickstart/index.md +++ b/content/get-started/quickstart/index.md @@ -15,7 +15,6 @@ children: - /creating-an-account-on-github - /hello-world - /set-up-git - - /create-a-repo - /fork-a-repo - /github-flow - /contributing-to-projects diff --git a/content/get-started/quickstart/set-up-git.md b/content/get-started/quickstart/set-up-git.md index 829bf4347069..1b3e69421807 100644 --- a/content/get-started/quickstart/set-up-git.md +++ b/content/get-started/quickstart/set-up-git.md @@ -32,7 +32,7 @@ If you want to work with Git locally, but do not want to use the command line, y If you do not need to work with files locally, {% data variables.product.product_name %} lets you complete many Git-related actions directly in the browser, including: -- [Creating a repository](/get-started/quickstart/create-a-repo) +- [AUTOTITLE](/repositories/creating-and-managing-repositories/quickstart-for-repositories) - [Forking a repository](/get-started/quickstart/fork-a-repo) - [Managing files](/repositories/working-with-files/managing-files) - [Being social](/get-started/quickstart/be-social) diff --git a/content/github-cli/index.md b/content/github-cli/index.md index 247a894f343e..c3916551f379 100644 --- a/content/github-cli/index.md +++ b/content/github-cli/index.md @@ -23,7 +23,7 @@ featuredLinks: - /pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request - /issues/tracking-your-work-with-issues/creating-an-issue - /authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account - - /get-started/quickstart/create-a-repo + - /repositories/creating-and-managing-repositories/quickstart-for-repositories - /pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally - /pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request - /get-started/quickstart/fork-a-repo diff --git a/content/repositories/creating-and-managing-repositories/about-repositories.md b/content/repositories/creating-and-managing-repositories/about-repositories.md index 68c638f790d1..52b89db93886 100644 --- a/content/repositories/creating-and-managing-repositories/about-repositories.md +++ b/content/repositories/creating-and-managing-repositories/about-repositories.md @@ -24,7 +24,7 @@ topics: A repository is the most basic element of {% data variables.product.prodname_dotcom %}. It's a place where you can store your code, your files, and each file's revision history. Repositories can have multiple collaborators and can be either public{% ifversion ghes or ghec %}, internal,{% endif %} or private. -To create a new repository, go to [https://github.com/new](https://github.com/new). For instructions, see "[AUTOTITLE](/get-started/quickstart/create-a-repo)." +To create a new repository, go to [https://github.com/new](https://github.com/new). For instructions, see "[AUTOTITLE](/repositories/creating-and-managing-repositories/quickstart-for-repositories)." ## Repository terminology diff --git a/content/repositories/creating-and-managing-repositories/index.md b/content/repositories/creating-and-managing-repositories/index.md index 765c772c722f..72a922e064b8 100644 --- a/content/repositories/creating-and-managing-repositories/index.md +++ b/content/repositories/creating-and-managing-repositories/index.md @@ -14,6 +14,7 @@ topics: children: - /about-repositories - /best-practices-for-repositories + - /quickstart-for-repositories - /repository-limits - /creating-a-new-repository - /creating-a-repository-from-a-template diff --git a/content/get-started/quickstart/create-a-repo.md b/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md similarity index 75% rename from content/get-started/quickstart/create-a-repo.md rename to content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md index 5dc81bf1a225..87da8931ae50 100644 --- a/content/get-started/quickstart/create-a-repo.md +++ b/content/repositories/creating-and-managing-repositories/quickstart-for-repositories.md @@ -1,11 +1,13 @@ --- -title: Create a repo +title: Quickstart for repositories +type: quick_start 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.prodname_dotcom %}, you will need to create a repository for it to live in.' + - /get-started/quickstart/create-a-repo +intro: 'Learn how to create a new repository and commit your first change in 5 minutes.' versions: fpt: '*' ghes: '*' @@ -19,28 +21,7 @@ topics: --- ## Create a repository -{% ifversion fpt or ghec %} - -You can store a variety of projects in {% data variables.product.prodname_dotcom %} repositories, including open source projects. With open source projects, 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 "[AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories)." To learn more about open source projects, visit [OpenSource.org](https://opensource.org/about). - -{% elsif ghes or ghae %} - -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 %} - -{% ifversion fpt or ghec %} - -{% note %} - -**Notes:** -- 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 %} -- You can also add community health files to your repositories, to set guidelines on how to contribute, keep your repositories safe, and much more. For more information, see "[AUTOTITLE](/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)." - -{% endnote %} - -{% endif %} +{% data variables.product.product_name %} repositories store a variety of projects. In this guide, you'll create a repository and commit your first change. {% webui %} diff --git a/content/repositories/index.md b/content/repositories/index.md index 09c9105c3101..fed306eb9f74 100644 --- a/content/repositories/index.md +++ b/content/repositories/index.md @@ -3,7 +3,7 @@ title: Repositories documentation shortTitle: Repositories intro: Learn to use and manage the repositories that allow you to store and collaborate on your project's code. introLinks: - quickstart: /get-started/quickstart/create-a-repo + quickstart: /repositories/creating-and-managing-repositories/quickstart-for-repositories overview: /repositories/creating-and-managing-repositories/about-repositories featuredLinks: startHere: diff --git a/data/reusables/getting-started/create-a-repository.md b/data/reusables/getting-started/create-a-repository.md index 83343b0b2954..588d68ceb39f 100644 --- a/data/reusables/getting-started/create-a-repository.md +++ b/data/reusables/getting-started/create-a-repository.md @@ -1 +1 @@ -Creating a repository for your project allows you to store code in {% data variables.product.prodname_dotcom %}. This provides a backup of your work that you can choose to share with other developers. For more information, see “[Create a repository](/get-started/quickstart/create-a-repo)." +Creating a repository for your project allows you to store code in {% data variables.product.prodname_dotcom %}. This provides a backup of your work that you can choose to share with other developers. For more information, see “[AUTOTITLE](/repositories/creating-and-managing-repositories/quickstart-for-repositories)."