1
0
mirror of synced 2025-12-19 18:10:59 -05:00

[Improvement]: Get started (phase 1): Move "Fork a repo" and "Contributing to projects" #12501 (#47687)

This commit is contained in:
Anne-Marie
2023-12-15 09:53:20 +01:00
committed by GitHub
parent 052fb87a9b
commit 1459ee6c32
17 changed files with 31 additions and 28 deletions

View File

@@ -38,7 +38,7 @@ You need to start by forking the demo repository.
1. Navigate to [https://github.com/dependabot/demo](https://github.com/dependabot/demo).
1. At the top of the page, on the right, click **{% octicon "repo-forked" aria-hidden="true" %} Fork**.
1. Select an owner (you can select your {% data variables.product.prodname_dotcom %} personal account) and type a repository name. For more information about forking repositories, see "[AUTOTITLE](/get-started/quickstart/fork-a-repo#forking-a-repository)."
1. Select an owner (you can select your {% data variables.product.prodname_dotcom %} personal account) and type a repository name. For more information about forking repositories, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#forking-a-repository)."
1. Click **Create fork**.
## Enabling {% data variables.product.prodname_dependabot %} for your repository

View File

@@ -18,7 +18,7 @@ For more information, see "[AUTOTITLE](/free-pro-team@latest/codespaces/overview
The following steps assume you have {% data variables.product.prodname_github_codespaces %} set up to edit files using {% data variables.product.prodname_vscode %} for Web. The steps are very similar if you have set a different editor. For more information, see "[AUTOTITLE](/free-pro-team@latest/codespaces/customizing-your-codespace/setting-your-default-editor-for-codespaces)."
1. Navigate to the open source repository for {% data variables.product.prodname_docs %}, [`github/docs`](https://github.com/github/docs).
1. If you're an open source contributor, create a fork of the repository, then follow the rest of the steps in this procedure from your fork. For more information, see "[AUTOTITLE](/get-started/quickstart/fork-a-repo)."
1. If you're an open source contributor, create a fork of the repository, then follow the rest of the steps in this procedure from your fork. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)."
1. Create a branch to work on. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository)."
1. On the main page of the repository, click **{% octicon "code" aria-hidden="true" %} Code**, then click **Create codespace on BRANCH-NAME**.

View File

@@ -32,7 +32,7 @@ You can also clone a repository directly from {% data variables.product.prodname
## Forking a repository
You can fork a repository on {% data variables.product.prodname_dotcom_the_website %} or in {% data variables.product.prodname_desktop %}. For information about forking on {% data variables.product.prodname_dotcom_the_website %}, see "[AUTOTITLE](/get-started/quickstart/fork-a-repo?tool=webui)."
You can fork a repository on {% data variables.product.prodname_dotcom_the_website %} or in {% data variables.product.prodname_desktop %}. For information about forking on {% data variables.product.prodname_dotcom_the_website %}, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo?tool=webui)."
{% data reusables.desktop.forking-a-repo %}

View File

@@ -1,5 +1,6 @@
---
title: Contributing to projects
title: Contributing to a project
shortTitle: Contribute to a project
intro: Learn how to contribute to a project through forking.
permissions: '{% data reusables.enterprise-accounts.emu-permission-fork %}'
versions:
@@ -12,6 +13,8 @@ topics:
- Forks
- GitHub
- Open Source
redirect_from:
- /get-started/quickstart/contributing-to-projects
---
## About forking
@@ -20,7 +23,7 @@ If you want to contribute to someone else's project but don't have write access
{% data reusables.repositories.fork-definition-long %}
You can contribute by submitting pull requests from your fork to the upstream repository. For more information, see "[AUTOTITLE](/get-started/quickstart/fork-a-repo)."
You can contribute by submitting pull requests from your fork to the upstream repository. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)."
## Forking a repository
@@ -195,7 +198,7 @@ To do so, head on over to the repository on {% data variables.product.product_na
## Managing feedback
Pull Requests are an area for discussion. In this case, the Octocat is very busy, and probably won't merge your changes. For other projects, don't be offended if the project owner rejects your pull request, or asks for more information on why it's been made. It may even be that the project owner chooses not to merge your pull request, and that's totally okay. Your changes exist in your fork. And who knows--maybe someone you've never met will find your changes much more valuable than the original project.
Pull requests are an area for discussion. Don't be offended if the project owner rejects your pull request, or asks for more information on why it's been made. Even if the project owner chooses not to merge your pull request, your changes still exist in your fork. It could be that someone else will find your fork much more valuable than the original project.
## Finding projects

View File

@@ -16,9 +16,10 @@ topics:
- Projects
children:
- /finding-ways-to-contribute-to-open-source-on-github
- /contributing-to-a-project
- /saving-repositories-with-stars
- /following-people
- /following-organizations
shortTitle: Explore projects
---

View File

@@ -15,9 +15,7 @@ children:
- /creating-an-account-on-github
- /hello-world
- /set-up-git
- /fork-a-repo
- /github-flow
- /contributing-to-projects
- /be-social
- /communicating-on-github
- /github-glossary
@@ -26,3 +24,4 @@ children:
redirect_from:
- /github/getting-started-with-github/quickstart
---

View File

@@ -33,7 +33,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:
- [AUTOTITLE](/repositories/creating-and-managing-repositories/quickstart-for-repositories)
- [Forking a repository](/get-started/quickstart/fork-a-repo)
- [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)
- [Managing files](/repositories/working-with-files/managing-files)
- [Being social](/get-started/quickstart/be-social)

View File

@@ -163,4 +163,4 @@ There are two primary ways people collaborate on {% data variables.product.produ
With a shared repository, individuals and teams are explicitly designated as contributors with read, write, or administrator access. This simple permission structure, combined with features like protected branches, helps teams progress quickly when they adopt {% data variables.product.product_name %}.
For an open source project, or for projects to which anyone can contribute, managing individual permissions can be challenging, but a fork and pull model allows anyone who can view the project to contribute. A fork is a copy of a project under a developer's personal account. Every developer has full control of their fork and is free to implement a fix or a new feature. Work completed in forks is either kept separate, or is surfaced back to the original project via a pull request. There, maintainers can review the suggested changes before they're merged. For more information, see "[AUTOTITLE](/get-started/quickstart/contributing-to-projects)."
For an open source project, or for projects to which anyone can contribute, managing individual permissions can be challenging, but a fork and pull model allows anyone who can view the project to contribute. A fork is a copy of a project under a developer's personal account. Every developer has full control of their fork and is free to implement a fix or a new feature. Work completed in forks is either kept separate, or is surfaced back to the original project via a pull request. There, maintainers can review the suggested changes before they're merged. For more information, see "[AUTOTITLE](/get-started/exploring-projects-on-github/contributing-to-a-project)."

View File

@@ -1,6 +1,6 @@
---
title: "{% data variables.product.prodname_cli %} documentation"
shortTitle: "{% data variables.product.prodname_cli %}"
title: '{% data variables.product.prodname_cli %} documentation'
shortTitle: '{% data variables.product.prodname_cli %}'
intro: '{% data reusables.cli.about-cli %}'
versions:
fpt: '*'
@@ -26,7 +26,7 @@ featuredLinks:
- /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
- /pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo
- /repositories/creating-and-managing-repositories/cloning-a-repository
popularHeading: Popular CLI tasks
changelog:

View File

@@ -33,7 +33,7 @@ Deleting a fork will not delete the original upstream repository. You can make a
{% data reusables.repositories.you-can-fork %}
For instructions for forking a repository, see "[AUTOTITLE](/get-started/quickstart/fork-a-repo#forking-a-repository)." For more information about when you can create forks, and the permission and visibility settings of forks, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-permissions-and-visibility-of-forks)."
For instructions for forking a repository, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)." For more information about when you can create forks, and the permission and visibility settings of forks, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-permissions-and-visibility-of-forks)."
{% tip %}

View File

@@ -1,11 +1,13 @@
---
title: Fork a repo
title: Fork a repository
allowTitleToDifferFromFilename: true
redirect_from:
- /fork-a-repo
- /forking
- /articles/fork-a-repo
- /github/getting-started-with-github/fork-a-repo
- /github/getting-started-with-github/quickstart/fork-a-repo
- /get-started/quickstart/fork-a-repo
intro: A fork is a new repository that shares code and visibility settings with the original “upstream” repository.
permissions: '{% data reusables.enterprise-accounts.emu-permission-fork %}'
versions:
@@ -96,7 +98,7 @@ gh repo fork REPOSITORY --org "octo-org"
{% desktop %}
You can fork a repository on {% data variables.product.prodname_dotcom_the_website %} or in {% data variables.product.prodname_desktop %}. For information about forking on {% data variables.product.prodname_dotcom_the_website %}, see [the web browser version of this article](/get-started/quickstart/fork-a-repo?tool=webui).
You can fork a repository on {% data variables.product.prodname_dotcom_the_website %} or in {% data variables.product.prodname_desktop %}. For information about forking on {% data variables.product.prodname_dotcom_the_website %}, see [the web browser version of this article](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo?tool=webui).
{% data reusables.desktop.forking-a-repo %}
@@ -228,12 +230,10 @@ Fork a repository to start contributing to a project. {% data reusables.reposito
{% endif %}
## Next Steps
## Next steps
You have now forked a repository, practiced cloning your fork, and configured an upstream repository.
- For more information about cloning the fork and syncing the changes in a forked repository from your computer, see "[AUTOTITLE](/get-started/quickstart/set-up-git)."
- You can also create a new repository where you can put all your projects and share the code on {% data variables.product.prodname_dotcom %}. {% data reusables.getting-started.create-a-repository %}"
- {% data reusables.getting-started.being-social %}

View File

@@ -14,10 +14,10 @@ topics:
- Pull requests
children:
- /about-forks
- /fork-a-repo
- /about-permissions-and-visibility-of-forks
- /configuring-a-remote-repository-for-a-fork
- /syncing-a-fork
- /allowing-changes-to-a-pull-request-branch-created-from-a-fork
- /what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility
---

View File

@@ -44,7 +44,7 @@ shortTitle: Edit files
## Editing files in another user's repository
When you edit a file in another user's repository, we'll automatically [fork the repository](/get-started/quickstart/fork-a-repo) and [open a pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for you.
When you edit a file in another user's repository, we'll automatically [fork the repository](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) and [open a pull request](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for you.
1. In another user's repository, browse to the folder that contains the file you want to edit. Click the name of the file you want to edit.
1. Above the file content, click {% octicon "pencil" aria-label="Edit file" %}. At this point, {% data variables.product.prodname_dotcom %} forks the repository for you.

View File

@@ -28,7 +28,7 @@ Please contact Support to request removal of a payment method from a locked out
## Can I recover the contents of a user or organization account I lost access to?
If you have lost access to a user account, you may [clone](/repositories/creating-and-managing-repositories/cloning-a-repository) or [fork](/get-started/quickstart/fork-a-repo) any content that is public.
If you have lost access to a user account, you may [clone](/repositories/creating-and-managing-repositories/cloning-a-repository) or [fork](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) any content that is public.
If you have lost access to an organization account, you may clone or fork any content that is public and you may be able to request that remaining members of the organization clone or fork any private content.

View File

@@ -1 +1 @@
{% data variables.product.prodname_dotcom %} connects users and allows you to interact with other projects. To learn more about contributing to someone else's project, see "[AUTOTITLE](/get-started/quickstart/contributing-to-projects)."
{% data variables.product.prodname_dotcom %} connects users and allows you to interact with other projects. To learn more about contributing to someone else's project, see "[AUTOTITLE](/get-started/exploring-projects-on-github/contributing-to-a-project)."

View File

@@ -1 +1 @@
Forking a repository will allow you to make changes to another repository without affecting the original. For more information, see "[AUTOTITLE](/get-started/quickstart/fork-a-repo)."
Forking a repository will allow you to make changes to another repository without affecting the original. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)."

View File

@@ -311,7 +311,7 @@ describe('redirects', () => {
})
describe('enterprise user article', () => {
const userArticle = `/en/enterprise-server@${enterpriseServerReleases.latest}/get-started/quickstart/fork-a-repo`
const userArticle = `/en/enterprise-server@${enterpriseServerReleases.latest}/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo`
test('no product redirects to GitHub.com product on the latest version', async () => {
const res = await get(
@@ -343,7 +343,7 @@ describe('redirects', () => {
})
describe('enterprise user article with frontmatter redirect', () => {
const userArticle = `/en/enterprise-server@${enterpriseServerReleases.latest}/get-started/quickstart/fork-a-repo`
const userArticle = `/en/enterprise-server@${enterpriseServerReleases.latest}/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo`
const redirectFromPath = '/articles/fork-a-repo'
test('redirects to expected article', async () => {