Skip to content

Commit

Permalink
Merge pull request #54337 from github/repo-sync
Browse files Browse the repository at this point in the history
Repo sync
  • Loading branch information
docs-bot authored Feb 10, 2025
2 parents dfe64ef + fbb42b3 commit 104055a
Show file tree
Hide file tree
Showing 11 changed files with 24 additions and 17 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -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).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 %}
Expand All @@ -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.
Expand All @@ -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.
Expand Down
3 changes: 3 additions & 0 deletions data/reusables/desktop/choose-local-path-url-tab.md
Original file line number Diff line number Diff line change
@@ -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.

![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)
3 changes: 3 additions & 0 deletions data/reusables/desktop/cloning-location-url-tab.md
Original file line number Diff line number Diff line change
@@ -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.

![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)

Check warning on line 3 in data/reusables/desktop/cloning-location-url-tab.md

View workflow job for this annotation

GitHub Actions / lint-content

Image alternate text is 162 characters long.
3 changes: 3 additions & 0 deletions data/reusables/desktop/cloning-repository-url.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
1. Enter the url or path of the repository you want to clone.

![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)
3 changes: 3 additions & 0 deletions data/reusables/desktop/create-fork-prompt.md
Original file line number Diff line number Diff line change
@@ -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.

![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)
9 changes: 5 additions & 4 deletions data/reusables/desktop/forking-a-repo.md
Original file line number Diff line number Diff line change
@@ -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 %}

0 comments on commit 104055a

Please sign in to comment.