Skip to content

Commit fbb42b3

Browse files
warp-coreNikkitorysteveward
authored
Updated GitHub desktop fork instructions (#36172)
Co-authored-by: Nikki Trebilco <[email protected]> Co-authored-by: Steve Ward <[email protected]>
1 parent 0ea440e commit fbb42b3

11 files changed

+24
-17
lines changed
Loading
Loading
Loading
Loading

content/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ You can create a local copy of any repository on {% data variables.product.githu
1818

1919
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).
2020

21-
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).
21+
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).
2222

2323
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).
2424

content/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo.md

+6-12
Original file line numberDiff line numberDiff line change
@@ -95,12 +95,12 @@ You can fork a repository on {% data variables.product.prodname_dotcom_the_websi
9595

9696
{% enddesktop %}
9797

98+
{% webui %}
99+
98100
## Cloning your forked repository
99101

100102
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.
101103

102-
{% webui %}
103-
104104
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.
105105
{% data reusables.repositories.copy-clone-url %}
106106
{% 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
126126

127127
{% cli %}
128128

129+
## Cloning your forked repository
130+
131+
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.
132+
129133
{% data reusables.cli.cli-learn-more %}
130134

131135
To create a clone of your fork, use the `--clone` flag.
@@ -136,16 +140,6 @@ gh repo fork REPOSITORY --clone=true
136140

137141
{% endcli %}
138142

139-
{% desktop %}
140-
141-
{% data reusables.desktop.choose-clone-repository %}
142-
{% data reusables.desktop.cloning-location-tab %}
143-
{% data reusables.desktop.cloning-repository-list %}
144-
{% data reusables.desktop.choose-local-path %}
145-
{% data reusables.desktop.click-clone %}
146-
147-
{% enddesktop %}
148-
149143
## Configuring Git to sync your fork with the upstream repository
150144

151145
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.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
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.
2+
3+
![Screenshot of the "URL" tab of the "Clone a repository" window. A button, labeled "Choose", is highlighted with an orange outline.](/assets/images/help/desktop/clone-choose-button-url-windows.png)
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
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.
2+
3+
![Screenshot of the "URL" tab of the "Clone a repository" window. At the top of the window, "GitHub.com", "GitHub Enterprise" and "URL" tabs are outlined in orange.](/assets/images/help/desktop/choose-repository-location-url-tab-windows.png)
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
1. Enter the url or path of the repository you want to clone.
2+
3+
![Screenshot of the "URL" tab of the "Clone a repository" window. The input containing "octocat/Spoon-Knife" is highlighted with an orange outline.](/assets/images/help/desktop/clone-a-repository-url-tab-name-input.png)
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
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.
2+
3+
![Screenshot of the "Create a fork prompt" window. A button, labeled "Fork this repository", is highlighted with an orange outline.](/assets/images/help/desktop/create-fork-button-windows.png)
+5-4
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
1-
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.
1+
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.
22

33
{% data reusables.desktop.choose-clone-repository %}
4-
{% data reusables.desktop.cloning-location-tab %}
5-
{% data reusables.desktop.cloning-repository-list %}
6-
{% data reusables.desktop.choose-local-path %}
4+
{% data reusables.desktop.cloning-location-url-tab %}
5+
{% data reusables.desktop.cloning-repository-url %}
6+
{% data reusables.desktop.choose-local-path-url-tab %}
77
{% data reusables.desktop.click-clone %}
8+
{% data reusables.desktop.create-fork-prompt %}
89
{% data reusables.desktop.fork-type-prompt %}

0 commit comments

Comments
 (0)