Updated GitHub desktop fork instructions (#36172)
Co-authored-by: Nikki Trebilco <104720506+Nikkitory@users.noreply.github.com> Co-authored-by: Steve Ward <steveward@github.com>
This commit is contained in:
Binary file not shown.
|
After Width: | Height: | Size: 57 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
BIN
assets/images/help/desktop/clone-choose-button-url-windows.png
Normal file
BIN
assets/images/help/desktop/clone-choose-button-url-windows.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 57 KiB |
BIN
assets/images/help/desktop/create-fork-button-windows.png
Normal file
BIN
assets/images/help/desktop/create-fork-button-windows.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 84 KiB |
@@ -18,7 +18,7 @@ You can create a local copy of any repository on {% data variables.product.githu
|
||||
|
||||
When you clone a repository, any changes you push to {% data variables.product.github %} will affect the original repository. To make changes without affecting the original project, you can create a separate copy by forking the repository. You can create a pull request to propose that maintainers incorporate the changes in your fork into the original upstream repository. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks).
|
||||
|
||||
When you try to use {% data variables.product.prodname_desktop %} to clone a repository that you do not have write access to, {% data variables.product.prodname_desktop %} will prompt you to create a fork automatically. You can choose to use your fork to contribute to the original upstream repository or to work independently on your own project. Any existing forks default to contributing changes to their upstream repositories. You can modify this choice at any time. For more information, see [Managing fork behavior](#managing-fork-behavior).
|
||||
When you use {% data variables.product.prodname_desktop %} to push a change to a repository that you do not have write access to, {% data variables.product.prodname_desktop %} will prompt you to create a fork. You can choose to use your fork to contribute to the original upstream repository or to work independently on your own project. Any existing forks default to contributing changes to their upstream repositories. You can modify this choice at any time. For more information, see [Managing fork behavior](#managing-fork-behavior).
|
||||
|
||||
You can also clone a repository directly from {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}. For more information, see [AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop).
|
||||
|
||||
|
||||
@@ -95,12 +95,12 @@ You can fork a repository on {% data variables.product.prodname_dotcom_the_websi
|
||||
|
||||
{% enddesktop %}
|
||||
|
||||
{% webui %}
|
||||
|
||||
## Cloning your forked repository
|
||||
|
||||
Right now, you have a fork of the Spoon-Knife repository, but you do not have the files in that repository locally on your computer.
|
||||
|
||||
{% webui %}
|
||||
|
||||
1. On {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.location.product_location %}{% endif %}, navigate to **your fork** of the Spoon-Knife repository.
|
||||
{% data reusables.repositories.copy-clone-url %}
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
@@ -126,6 +126,10 @@ Right now, you have a fork of the Spoon-Knife repository, but you do not have th
|
||||
|
||||
{% cli %}
|
||||
|
||||
## Cloning your forked repository
|
||||
|
||||
Right now, you have a fork of the Spoon-Knife repository, but you do not have the files in that repository locally on your computer.
|
||||
|
||||
{% data reusables.cli.cli-learn-more %}
|
||||
|
||||
To create a clone of your fork, use the `--clone` flag.
|
||||
@@ -136,16 +140,6 @@ gh repo fork REPOSITORY --clone=true
|
||||
|
||||
{% endcli %}
|
||||
|
||||
{% desktop %}
|
||||
|
||||
{% data reusables.desktop.choose-clone-repository %}
|
||||
{% data reusables.desktop.cloning-location-tab %}
|
||||
{% data reusables.desktop.cloning-repository-list %}
|
||||
{% data reusables.desktop.choose-local-path %}
|
||||
{% data reusables.desktop.click-clone %}
|
||||
|
||||
{% enddesktop %}
|
||||
|
||||
## Configuring Git to sync your fork with the upstream repository
|
||||
|
||||
When you fork a project in order to propose changes to the upstream repository, you can configure Git to pull changes from the upstream repository into the local clone of your fork.
|
||||
|
||||
3
data/reusables/desktop/choose-local-path-url-tab.md
Normal file
3
data/reusables/desktop/choose-local-path-url-tab.md
Normal file
@@ -0,0 +1,3 @@
|
||||
1. To select the local directory into which you want to clone the repository, next to the "Local Path" field, click **Choose...** and navigate to the directory.
|
||||
|
||||

|
||||
3
data/reusables/desktop/cloning-location-url-tab.md
Normal file
3
data/reusables/desktop/cloning-location-url-tab.md
Normal file
@@ -0,0 +1,3 @@
|
||||
1. Click the tab that corresponds to the location of the repository you want to clone. In this example, we click on the URL tab.
|
||||
|
||||

|
||||
3
data/reusables/desktop/cloning-repository-url.md
Normal file
3
data/reusables/desktop/cloning-repository-url.md
Normal file
@@ -0,0 +1,3 @@
|
||||
1. Enter the url or path of the repository you want to clone.
|
||||
|
||||

|
||||
3
data/reusables/desktop/create-fork-prompt.md
Normal file
3
data/reusables/desktop/create-fork-prompt.md
Normal file
@@ -0,0 +1,3 @@
|
||||
1. To create a fork, attempt to push a change to the repository. For example, create a new branch and publish it. A prompt will appear asking if you want to fork this repository.
|
||||
|
||||

|
||||
@@ -1,8 +1,9 @@
|
||||
In {% data variables.product.prodname_desktop %}, if you attempt to clone a repository that you don't have write access to, a fork is automatically created for you.
|
||||
In {% data variables.product.prodname_desktop %}, if you clone a repository that you do not have write access to, and then attempt to push a change to the repository, a fork will be created for you.
|
||||
|
||||
{% data reusables.desktop.choose-clone-repository %}
|
||||
{% data reusables.desktop.cloning-location-tab %}
|
||||
{% data reusables.desktop.cloning-repository-list %}
|
||||
{% data reusables.desktop.choose-local-path %}
|
||||
{% data reusables.desktop.cloning-location-url-tab %}
|
||||
{% data reusables.desktop.cloning-repository-url %}
|
||||
{% data reusables.desktop.choose-local-path-url-tab %}
|
||||
{% data reusables.desktop.click-clone %}
|
||||
{% data reusables.desktop.create-fork-prompt %}
|
||||
{% data reusables.desktop.fork-type-prompt %}
|
||||
|
||||
Reference in New Issue
Block a user