зеркало из https://github.com/github/docs.git
Add article "About GitHub Desktop" (#41963)
Co-authored-by: Laura Coursen <lecoursen@github.com>
This commit is contained in:
Isaac Brown
GitHub
Родитель
2e6121afad
Коммит
221d23006b
|
|
@ -49,4 +49,4 @@ If you have low vision, you may benefit from a high contrast theme, with greater
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop)"
|
||||
- "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop)"
|
||||
|
|
|
|||
|
|
@ -80,7 +80,7 @@ You can authenticate to {% data variables.product.product_name %} in your browse
|
|||
|
||||
## Authenticating with {% data variables.product.prodname_desktop %}
|
||||
|
||||
You can authenticate with {% data variables.product.prodname_desktop %} using your browser. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
You can authenticate with {% data variables.product.prodname_desktop %} using your browser. For more information, see "[AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
|
||||
## Authenticating with the API
|
||||
|
||||
|
|
|
|||
|
|
@ -4,6 +4,7 @@ intro: 'You can add any Git repository to {% data variables.product.prodname_des
|
|||
redirect_from:
|
||||
- /desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/adding-a-repository-from-your-local-computer-to-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Add a repository
|
||||
|
|
@ -4,13 +4,14 @@ intro: 'You can add an existing Git repository to {% data variables.product.prod
|
|||
redirect_from:
|
||||
- /desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/adding-an-existing-project-to-github-using-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-an-existing-project-to-github-using-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Add an existing project
|
||||
---
|
||||
|
||||
{% data reusables.git.remove-git-remote %}
|
||||
1. [Add the repository to GitHub Desktop](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop).
|
||||
1. [Add the repository to GitHub Desktop](/desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop).
|
||||
{% data reusables.desktop.publish-repository %}
|
||||
1. In the "Publish Repository" window, in the "Name" field, type the desired name of the repository or use the default current local repository name.
|
||||
1. Optionally, add a description for the repository.
|
||||
|
|
@ -4,13 +4,14 @@ intro: 'You can use {% data variables.product.prodname_dotcom %} to clone remote
|
|||
redirect_from:
|
||||
- /desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/cloning-a-repository-from-github-to-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Clone a GitHub repo
|
||||
---
|
||||
{% tip %}
|
||||
|
||||
**Tip:** You also can use {% data variables.product.prodname_desktop %} to clone repositories that exist on {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)."
|
||||
**Tip:** You also can use {% data variables.product.prodname_desktop %} to clone repositories that exist on {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)."
|
||||
|
||||
{% endtip %}
|
||||
|
||||
|
|
@ -14,13 +14,13 @@ shortTitle: Clone & fork from Desktop
|
|||
|
||||
Repositories on {% data variables.product.prodname_dotcom %} are remote repositories. You can clone or fork a repository with {% data variables.product.prodname_desktop %} to create a local repository on your computer.
|
||||
|
||||
You can create a local copy of any repository on {% data variables.product.product_name %} that you have access to by cloning the repository. If you own a repository or have write permissions, you can sync between the local and remote locations. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch-in-github-desktop)."
|
||||
You can create a local copy of any repository on {% data variables.product.product_name %} that you have access to by cloning the repository. If you own a repository or have write permissions, you can sync between the local and remote locations. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop)."
|
||||
|
||||
When you clone a repository, any changes you push to {% data variables.product.product_name %} 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)".
|
||||
|
||||
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/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)".
|
||||
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)".
|
||||
|
||||
## Cloning a repository
|
||||
|
||||
|
|
@ -3,6 +3,7 @@ title: Adding and cloning repositories
|
|||
intro: 'Add existing repositories from your local computer to {% data variables.product.prodname_desktop %}, or clone repositories from {% data variables.product.product_name %}.'
|
||||
redirect_from:
|
||||
- /desktop/contributing-to-projects/adding-and-cloning-repositories
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
|
|
@ -5,6 +5,7 @@ intro: '{% data variables.product.prodname_desktop %} includes {% data variables
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/about-git-large-file-storage-and-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/about-git-large-file-storage-and-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -5,6 +5,7 @@ redirect_from:
|
|||
- /desktop/getting-started-with-github-desktop/configuring-a-default-editor
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-a-default-editor
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Configure default editor
|
||||
|
|
@ -5,6 +5,7 @@ redirect_from:
|
|||
- /desktop/getting-started-with-github-desktop/configuring-basic-settings
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-basic-settings
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-basic-settings
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Configure basic settings
|
||||
|
|
@ -33,4 +34,4 @@ shortTitle: Configure basic settings
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop)"
|
||||
- "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop)"
|
||||
|
|
@ -5,6 +5,7 @@ intro: 'You can manage Git configuration settings for your local repositories wi
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-git-for-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -3,6 +3,7 @@ title: Configuring and customizing GitHub Desktop
|
|||
intro: 'Set up Git, connect your default editor, and customize settings to align GitHub Desktop with your workflow.'
|
||||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
|
|
@ -4,6 +4,7 @@ intro: You can set a theme to customize the look and feel of GitHub Desktop.
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/setting-a-theme-for-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Set a theme
|
||||
|
|
@ -1,16 +0,0 @@
|
|||
---
|
||||
title: Contributing and collaborating using GitHub Desktop
|
||||
shortTitle: Contributing and collaborating
|
||||
intro: 'Use GitHub Desktop to manage your projects, create meaningful commits, and track the project''s history in an app instead of on the command line.'
|
||||
redirect_from:
|
||||
- /desktop/contributing-to-projects
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
- /adding-and-cloning-repositories
|
||||
- /making-changes-in-a-branch
|
||||
- /managing-commits
|
||||
- /working-with-your-remote-repository-on-github-or-github-enterprise
|
||||
- /keeping-your-local-repository-in-sync-with-github
|
||||
---
|
||||
|
||||
|
|
@ -1,10 +0,0 @@
|
|||
---
|
||||
title: Keeping your local repository in sync with GitHub
|
||||
intro: 'You can keep your local repository in sync with your remote repository as you make changes to either one. In Git, a *remote* is the server where your code is stored. In your case, that server is a repository on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}.'
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
- /syncing-your-branch-in-github-desktop
|
||||
shortTitle: Sync your local repo
|
||||
---
|
||||
|
||||
|
|
@ -3,23 +3,24 @@ title: GitHub Desktop documentation
|
|||
shortTitle: GitHub Desktop
|
||||
intro: 'With GitHub Desktop, you can interact with GitHub using a GUI instead of the command line or a web browser. You can use GitHub Desktop to complete most Git commands from your desktop, such as pushing to, pulling from, and cloning remote repositories, attributing commits, and creating pull requests, with visual confirmation of changes.'
|
||||
introLinks:
|
||||
overview: /desktop/installing-and-configuring-github-desktop/overview/getting-started-with-github-desktop
|
||||
overview: /desktop/overview/about-github-desktop
|
||||
quickstart: /desktop/overview/getting-started-with-github-desktop
|
||||
featuredLinks:
|
||||
startHere:
|
||||
- /desktop/installing-and-configuring-github-desktop/overview/creating-your-first-repository-using-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop
|
||||
- /desktop/overview/creating-your-first-repository-using-github-desktop
|
||||
- /desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop
|
||||
- /desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop
|
||||
guideCards:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reverting-a-commit-in-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/amending-a-commit-in-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/cherry-picking-a-commit-in-github-desktop
|
||||
- /desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop
|
||||
- /desktop/managing-commits/reverting-a-commit-in-github-desktop
|
||||
- /desktop/managing-commits/amending-a-commit-in-github-desktop
|
||||
- /desktop/managing-commits/cherry-picking-a-commit-in-github-desktop
|
||||
popular:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches-in-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch-in-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop
|
||||
- /desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop
|
||||
- /desktop/making-changes-in-a-branch/managing-branches-in-github-desktop
|
||||
- /desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop
|
||||
- /desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop
|
||||
- /desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop
|
||||
changelog:
|
||||
label: desktop
|
||||
versions:
|
||||
|
|
@ -31,6 +32,16 @@ topics:
|
|||
- Desktop
|
||||
- Repositories
|
||||
children:
|
||||
- /installing-and-configuring-github-desktop
|
||||
- /contributing-and-collaborating-using-github-desktop
|
||||
- /overview
|
||||
- /installing-and-authenticating-to-github-desktop
|
||||
- /configuring-and-customizing-github-desktop
|
||||
- /adding-and-cloning-repositories
|
||||
- /making-changes-in-a-branch
|
||||
- /managing-commits
|
||||
- /working-with-your-remote-repository-on-github-or-github-enterprise
|
||||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -5,11 +5,12 @@ redirect_from:
|
|||
- /desktop/getting-started-with-github-desktop/about-connections-to-github
|
||||
- /desktop/installing-and-configuring-github-desktop/about-connections-to-github
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/about-connections-to-github
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/about-connections-to-github-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: About connections
|
||||
---
|
||||
{% data variables.product.prodname_desktop %} connects to {% data variables.product.prodname_dotcom %} when you pull from, push to, clone, and fork remote repositories. To connect to {% data variables.product.prodname_dotcom %} from {% data variables.product.prodname_desktop %}, you must authenticate your account. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
{% data variables.product.prodname_desktop %} connects to {% data variables.product.prodname_dotcom %} when you pull from, push to, clone, and fork remote repositories. To connect to {% data variables.product.prodname_dotcom %} from {% data variables.product.prodname_desktop %}, you must authenticate your account. For more information, see "[AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
|
||||
After you authenticate to {% data variables.product.prodname_dotcom %}, you can connect to remote repositories with {% data variables.product.prodname_desktop %}. {% data variables.product.prodname_desktop %} caches your credentials (username and password or {% data variables.product.pat_generic %}) and uses the credentials to authenticate for each connection to the remote repository.
|
||||
|
||||
|
|
@ -17,4 +18,4 @@ After you authenticate to {% data variables.product.prodname_dotcom %}, you can
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)"
|
||||
- "[AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)"
|
||||
|
|
@ -7,6 +7,7 @@ redirect_from:
|
|||
- /desktop/getting-started-with-github-desktop/authenticating-to-github
|
||||
- /desktop/installing-and-configuring-github-desktop/authenticating-to-github
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -3,6 +3,7 @@ title: Installing and authenticating to GitHub Desktop
|
|||
intro: Install GitHub Desktop and connect your GitHub or GitHub Enterprise accounts.
|
||||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
|
|
@ -5,6 +5,7 @@ intro: You can install GitHub Desktop on supported Windows or macOS operating sy
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/installing-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -5,14 +5,15 @@ intro: 'You can set up {% data variables.product.prodname_desktop %} to suit you
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/setting-up-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/setting-up-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
## Part 1: Installing {% data variables.product.prodname_desktop %}
|
||||
|
||||
You can install {% data variables.product.prodname_desktop %} on any supported operating system. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/supported-operating-systems-for-github-desktop)."
|
||||
You can install {% data variables.product.prodname_desktop %} on any supported operating system. For more information, see "[AUTOTITLE](/desktop/overview/supported-operating-systems-for-github-desktop)."
|
||||
|
||||
To install {% data variables.product.prodname_desktop %}, navigate to [https://desktop.github.com/](https://desktop.github.com/) and download the appropriate version of {% data variables.product.prodname_desktop %} for your operating system. Follow the prompts to complete the installation. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop)."
|
||||
To install {% data variables.product.prodname_desktop %}, navigate to [https://desktop.github.com/](https://desktop.github.com/) and download the appropriate version of {% data variables.product.prodname_desktop %} for your operating system. Follow the prompts to complete the installation. For more information, see "[AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop)."
|
||||
|
||||
## Part 2: Configuring your account
|
||||
|
||||
|
|
@ -26,7 +27,7 @@ If you do not already have an account on {% data variables.location.product_loca
|
|||
|
||||
### Authenticating to {% data variables.product.prodname_dotcom %}
|
||||
|
||||
To connect to {% data variables.product.prodname_desktop %} with {% data variables.product.prodname_dotcom %}, you'll need to authenticate your account. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
To connect to {% data variables.product.prodname_desktop %} with {% data variables.product.prodname_dotcom %}, you'll need to authenticate your account. For more information, see "[AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
|
||||
After authenticating your account, you are ready to manage and contribute to projects with {% data variables.product.prodname_desktop %}.
|
||||
|
||||
|
|
@ -34,7 +35,7 @@ After authenticating your account, you are ready to manage and contribute to pro
|
|||
|
||||
You must have Git installed before using {% data variables.product.prodname_desktop %}. If you do not already have Git installed, you can download and install the latest version of Git from [https://git-scm.com/downloads](https://git-scm.com/downloads).
|
||||
|
||||
After you have Git installed, you'll need to configure Git for {% data variables.product.prodname_desktop %}. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop)."
|
||||
After you have Git installed, you'll need to configure Git for {% data variables.product.prodname_desktop %}. For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop)."
|
||||
|
||||
## Part 4: Customizing {% data variables.product.prodname_desktop %}
|
||||
|
||||
|
|
@ -42,8 +43,8 @@ You can adjust defaults and settings to tailor {% data variables.product.prodnam
|
|||
|
||||
### Choosing a default text editor
|
||||
|
||||
You can open a text editor from {% data variables.product.prodname_desktop %} to manipulate files and repositories. {% data variables.product.prodname_desktop %} supports a variety of text editors and integrated development environments (IDEs) for Windows and macOS. You can choose a default editor in the {% data variables.product.prodname_desktop %} settings. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop)."
|
||||
You can open a text editor from {% data variables.product.prodname_desktop %} to manipulate files and repositories. {% data variables.product.prodname_desktop %} supports a variety of text editors and integrated development environments (IDEs) for Windows and macOS. You can choose a default editor in the {% data variables.product.prodname_desktop %} settings. For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop)."
|
||||
|
||||
### Choosing a theme
|
||||
|
||||
{% data variables.product.prodname_desktop %} has multiple themes available to customize the look and feel of the app. You can choose a theme in the {% data variables.product.prodname_desktop %} settings. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop)."
|
||||
{% data variables.product.prodname_desktop %} has multiple themes available to customize the look and feel of the app. You can choose a theme in the {% data variables.product.prodname_desktop %} settings. For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/setting-a-theme-for-github-desktop)."
|
||||
|
|
@ -4,6 +4,7 @@ intro: You can uninstall GitHub Desktop from your computer at any time.
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/uninstalling-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/uninstalling-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/uninstalling-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Uninstalling
|
||||
|
|
@ -5,6 +5,7 @@ intro: GitHub Desktop automatically downloads updates and installs them when you
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/updating-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/updating-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/updating-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -1,14 +0,0 @@
|
|||
---
|
||||
title: Installing and configuring GitHub Desktop
|
||||
shortTitle: Installing and configuring
|
||||
intro: 'Get {% data variables.product.prodname_desktop %} set up to manage your project work. Authenticate to {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_enterprise %}, keep the app up-to-date, and review your preferred settings.'
|
||||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
- /overview
|
||||
- /installing-and-authenticating-to-github-desktop
|
||||
- /configuring-and-customizing-github-desktop
|
||||
---
|
||||
|
||||
|
|
@ -5,6 +5,7 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/committing-and-reviewing-changes-to-your-project
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Commit & review changes
|
||||
|
|
@ -13,7 +14,7 @@ shortTitle: Commit & review changes
|
|||
|
||||
{% data reusables.commits.about-commits %} You can also add a co-author on any commits you collaborate on.
|
||||
|
||||
{% data reusables.desktop.update-email-address %} For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop)."
|
||||
{% data reusables.desktop.update-email-address %} For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/configuring-git-for-github-desktop)."
|
||||
|
||||
{% ifversion repo-rules %}
|
||||
|
||||
|
|
@ -23,7 +24,7 @@ Repository administrators can enable rulesets for a branch to enforce specific c
|
|||
|
||||
## Choosing a branch and making changes
|
||||
|
||||
1. [Create a new branch](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches-in-github-desktop), or select an existing branch by clicking {% octicon "git-branch" aria-hidden="true" %} **Current Branch** on the toolbar and selecting the branch from the list.
|
||||
1. [Create a new branch](/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop), or select an existing branch by clicking {% octicon "git-branch" aria-hidden="true" %} **Current Branch** on the toolbar and selecting the branch from the list.
|
||||
|
||||
|
||||
{% data reusables.desktop.make-changes %}
|
||||
|
|
@ -105,7 +106,7 @@ Once you're satisfied with the changes you've chosen to include in your commit,
|
|||
|
||||
{% note %}
|
||||
|
||||
**Note**: {% data reusables.desktop.tags-push-with-commits %} For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/managing-commits/managing-tags-in-github-desktop)."
|
||||
**Note**: {% data reusables.desktop.tags-push-with-commits %} For more information, see "[AUTOTITLE](/desktop/managing-commits/managing-tags-in-github-desktop)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
|
@ -123,9 +124,9 @@ Once you're satisfied with the changes you've chosen to include in your commit,
|
|||
For more information about protected branches, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)."
|
||||
{% data reusables.desktop.push-origin %}
|
||||
|
||||
1. If you have a pull request based off the branch you are working on, {% data variables.product.prodname_desktop %} will display the status of the checks that have run for the pull request next to the "Current Branch" section of the repository bar. For more information about checks, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop)."
|
||||
1. If you have a pull request based off the branch you are working on, {% data variables.product.prodname_desktop %} will display the status of the checks that have run for the pull request next to the "Current Branch" section of the repository bar. For more information about checks, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop)."
|
||||
|
||||
If a pull request has not been created for the current branch, {% data variables.product.prodname_desktop %} will give you the option to preview the changes and create one. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop)."
|
||||
If a pull request has not been created for the current branch, {% data variables.product.prodname_desktop %} will give you the option to preview the changes and create one. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop)."
|
||||
|
||||
|
||||
|
||||
|
|
@ -3,6 +3,7 @@ title: Making changes in a branch
|
|||
intro: 'Use your favorite text editor, such as [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/), to make changes to your project, then use {% data variables.product.prodname_desktop %} to visualize useful commits.'
|
||||
redirect_from:
|
||||
- /desktop/contributing-to-projects/making-changes-in-a-branch
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
|
|
@ -8,6 +8,7 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/managing-branches
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-branches
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
|
||||
|
|
@ -20,7 +21,7 @@ You always create a branch from an existing branch. Typically, you might create
|
|||
|
||||
You can also create a branch starting from a previous commit in a branch's history. This can be helpful if you need to return to an earlier view of the repository to investigate a bug, or to create a hot fix on top of your latest release.
|
||||
|
||||
Once you're satisfied with your work, you can create a pull request to merge your changes in the current branch into another branch. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop)" and "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)."
|
||||
Once you're satisfied with your work, you can create a pull request to merge your changes in the current branch into another branch. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop)" and "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)."
|
||||
|
||||
You can always create a branch in {% data variables.product.prodname_desktop %} if you have read access to a repository, but you can only push the branch to {% data variables.product.prodname_dotcom %} if you have write access to the repository.
|
||||
|
||||
|
|
@ -70,10 +71,10 @@ If you create a branch on {% data variables.product.product_name %}, you'll need
|
|||
|
||||
## Switching between branches
|
||||
|
||||
You can view and make commits to any of your repository's branches. If you have uncommitted, saved changes, you'll need to decide what to do with your changes before you can switch branches. You can commit your changes on the current branch, stash your changes to temporarily save them on the current branch, or bring the changes to your new branch. If you want to commit your changes before switching branches, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)."
|
||||
You can view and make commits to any of your repository's branches. If you have uncommitted, saved changes, you'll need to decide what to do with your changes before you can switch branches. You can commit your changes on the current branch, stash your changes to temporarily save them on the current branch, or bring the changes to your new branch. If you want to commit your changes before switching branches, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)."
|
||||
{% tip %}
|
||||
|
||||
**Tip**: You can set a default behavior for switching branches in the **Advanced** settings. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop)."
|
||||
**Tip**: You can set a default behavior for switching branches in the **Advanced** settings. For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop)."
|
||||
|
||||
{% endtip %}
|
||||
|
||||
|
|
@ -103,8 +104,8 @@ You can't delete a branch if it's currently associated with an open pull request
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)"
|
||||
- "[AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)"
|
||||
- "[AUTOTITLE](/get-started/quickstart/github-glossary#branch)" in the {% data variables.product.prodname_dotcom %} glossary
|
||||
- "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches)"
|
||||
- "[Branches in a Nutshell](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell)" in the Git documentation
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop)"
|
||||
- "[AUTOTITLE](/desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop)"
|
||||
|
|
@ -7,6 +7,7 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/pushing-changes-to-github
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/pushing-changes-to-github
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -14,7 +15,7 @@ versions:
|
|||
|
||||
When you push changes, you send the committed changes in your local repository to the remote repository on {% data variables.product.prodname_dotcom %}. If you change your project locally and want other people to have access to the changes, you must push the changes to {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
Before pushing changes, you should update your local branch to include any commits that have been added to the remote repository. If someone has made commits on the remote that are not on your local branch, {% data variables.product.prodname_desktop %} will prompt you to fetch the new commits before pushing your changes to avoid merge conflicts. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch)."
|
||||
Before pushing changes, you should update your local branch to include any commits that have been added to the remote repository. If someone has made commits on the remote that are not on your local branch, {% data variables.product.prodname_desktop %} will prompt you to fetch the new commits before pushing your changes to avoid merge conflicts. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop)."
|
||||
|
||||
{% data reusables.desktop.protected-branches %}
|
||||
|
||||
|
|
@ -33,18 +34,18 @@ Repository administrators can also enable rulesets for a branch, which will prev
|
|||
- A push contains a large file over {% data variables.large_files.max_github_size %} in size.
|
||||
- A push is over {% data variables.large_files.max_file_size %} in total size.
|
||||
|
||||
If you configure {% data variables.large_files.product_name_long %} to track your large files, you can push large files that would normally be rejected. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop)."
|
||||
If you configure {% data variables.large_files.product_name_long %} to track your large files, you can push large files that would normally be rejected. For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.desktop.push-origin %}
|
||||
1. If there are commits on the remote branch that you don't have on your local branch, {% data variables.product.prodname_desktop %} prompts you to fetch new commits from the remote. In the "New Commits on Remote" window, click **Fetch**.
|
||||
1. Optionally, click **Preview Pull Request** to open a preview dialog where you can review your changes and begin to create a pull request. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop)."
|
||||
1. Optionally, click **Preview Pull Request** to open a preview dialog where you can review your changes and begin to create a pull request. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop)."
|
||||
|
||||
|
||||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/get-started/quickstart/github-glossary#push)" in the {% data variables.product.prodname_dotcom %} glossary
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)"
|
||||
- "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)"
|
||||
- "[AUTOTITLE](/get-started/using-git)"
|
||||
|
|
@ -7,12 +7,13 @@ versions:
|
|||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/stashing-changes
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/stashing-changes
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/stashing-changes-in-github-desktop
|
||||
---
|
||||
## About stashed changes
|
||||
|
||||
To apply your changes to your repository, you must save the files and then commit the changes to a branch. If you have saved changes that you are not ready to commit yet, you can stash the changes for later. When you stash changes, the changes are temporarily removed from the files and you can choose to restore or discard the changes later. You can only stash one set of changes at a time with {% data variables.product.prodname_desktop %}. If you use {% data variables.product.prodname_desktop %} to stash changes, all unsaved changes will be stashed. After you stash changes on a branch, you can safely change branches or make other changes to your current branch.
|
||||
|
||||
If you use {% data variables.product.prodname_desktop %} to switch branches while you have saved, but not committed, changes, {% data variables.product.prodname_desktop %} will prompt you to stash the changes or bring them to the other branch. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches-in-github-desktop#switching-between-branches)."
|
||||
If you use {% data variables.product.prodname_desktop %} to switch branches while you have saved, but not committed, changes, {% data variables.product.prodname_desktop %} will prompt you to stash the changes or bring them to the other branch. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop#switching-between-branches)."
|
||||
|
||||
## Stashing changes
|
||||
|
||||
|
|
@ -5,6 +5,7 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/viewing-the-branch-history
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/viewing-the-branch-history
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/viewing-the-branch-history
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/viewing-the-branch-history-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: View branch history
|
||||
|
|
@ -39,4 +40,4 @@ Each commit shows:
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch)"
|
||||
- "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop)"
|
||||
|
|
@ -6,6 +6,7 @@ versions:
|
|||
feature: desktop
|
||||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/amending-a-commit
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/amending-a-commit-in-github-desktop
|
||||
---
|
||||
|
||||
## About amending a commit
|
||||
|
|
@ -22,5 +23,5 @@ You can continue to amend a commit until you push it to the remote repository. A
|
|||
|
||||
1. In the "Amend Will Require Force Push" dialog window, click **Begin Amend**.
|
||||
1. In the "Changes" tab, use the **Summary** field to modify the commit message. Optionally, you can modify or add information about the commit in the **Description** field.
|
||||
1. Select any uncommitted changes that you would like to add to the commit. For more information about selecting changes, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project#selecting-changes-to-include-in-a-commit)."
|
||||
1. Select any uncommitted changes that you would like to add to the commit. For more information about selecting changes, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#selecting-changes-to-include-in-a-commit)."
|
||||
1. Once you have finalized your changes, click **Amend last commit**.
|
||||
|
|
@ -4,6 +4,8 @@ shortTitle: Checking out a commit
|
|||
intro: 'You can use {% data variables.product.prodname_desktop %} to checkout a previous commit in your repository.'
|
||||
versions:
|
||||
feature: desktop
|
||||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/checking-out-a-commit-in-github-desktop
|
||||
---
|
||||
|
||||
## About checking out a commit
|
||||
|
|
@ -25,7 +27,7 @@ Checking out a commit puts your repository in a "detached HEAD" state. In Git te
|
|||
|
||||
1. The {% octicon "git-branch" aria-hidden="true" %} **Current Branch** item in the repository bar will now show "Detached HEAD", along with the SHA of the commit that was checked out.
|
||||
|
||||
1. To exit the "detached HEAD" state you will need to switch branches. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches-in-github-desktop#switching-between-branches)."
|
||||
1. To exit the "detached HEAD" state you will need to switch branches. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop#switching-between-branches)."
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
|
|
@ -7,6 +7,7 @@ versions:
|
|||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/cherry-picking-a-commit
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/cherry-picking-a-commit
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/cherry-picking-a-commit-in-github-desktop
|
||||
---
|
||||
## About Git cherry-pick
|
||||
|
||||
|
|
@ -11,5 +11,7 @@ children:
|
|||
- /amending-a-commit-in-github-desktop
|
||||
- /managing-tags-in-github-desktop
|
||||
- /checking-out-a-commit-in-github-desktop
|
||||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits
|
||||
---
|
||||
|
||||
|
|
@ -6,6 +6,7 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/managing-tags
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-tags
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/managing-tags
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/managing-tags-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -6,6 +6,7 @@ versions:
|
|||
feature: desktop
|
||||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reordering-commits
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reordering-commits-in-github-desktop
|
||||
---
|
||||
|
||||
## About reordering a commit
|
||||
|
|
@ -6,6 +6,7 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/reverting-a-commit
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/reverting-a-commit
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reverting-a-commit
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/reverting-a-commit-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -6,6 +6,7 @@ versions:
|
|||
feature: desktop
|
||||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/squashing-commits
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/managing-commits/squashing-commits-in-github-desktop
|
||||
---
|
||||
|
||||
## About squashing a commit
|
||||
|
|
@ -0,0 +1,29 @@
|
|||
---
|
||||
title: About GitHub Desktop
|
||||
shortTitle: 'About'
|
||||
intro: '{% data variables.product.prodname_desktop %} helps you work with projects hosted on {% data variables.product.prodname_dotcom %}.'
|
||||
versions:
|
||||
feature: desktop
|
||||
redirect_from:
|
||||
- /desktop/installing-and-configuring-github-desktop/overview/about-github-desktop
|
||||
---
|
||||
|
||||
{% data variables.product.prodname_desktop %} is a free, open source application that helps you to work with files hosted on {% data variables.product.prodname_dotcom %} or other Git hosting services.
|
||||
|
||||
You can use {% data variables.product.prodname_desktop %} alongside any tools you need to contribute to a project. For example, a typical workflow would be to use {% data variables.product.prodname_desktop %} to download a {% data variables.product.prodname_dotcom %} repository to your computer and create a new branch, use an editor such as {% data variables.product.prodname_vscode %} to make changes to the code, then return to {% data variables.product.prodname_desktop %} to commit and push the changes to {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
Like any tool for contributing changes to repositories on {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_desktop %} is built around the version control software Git. If you're new to Git and {% data variables.product.prodname_dotcom %}, you may find it easier to get started with {% data variables.product.prodname_desktop %} than you would using Git on the command line. Because {% data variables.product.prodname_desktop %} has a graphical user interface, it simplifies many of the aspects of Git that can be challenging for new users, such as memorizing commands and visualizing the changes you're making.
|
||||
|
||||
Even if you have experience with command-line Git, you may benefit from incorporating {% data variables.product.prodname_desktop %} into your work. If you frequently need to look up syntax for less common Git commands, such as choosing which changed lines to include in a commit or adding a co-author to a commit, you may benefit from switching to {% data variables.product.prodname_desktop %} to perform these commands.
|
||||
|
||||
Because {% data variables.product.prodname_desktop %} makes commands like these easy to find, and helps you visualize the changes you're introducing with an integrated diff view, it encourages best practices and helps you to create an accurate and easy-to-follow commit history so other collaborators on a project can easily review your work.
|
||||
|
||||
Unlike other Git clients, {% data variables.product.prodname_desktop %} is specifically designed for use with {% data variables.product.prodname_dotcom %}, so it can make you more productive when working with repositories on {% data variables.product.prodname_dotcom %}. For example, you can authenticate to {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_ghe_server %} quickly, without needing to use a separate credential manager, and you can check out a pull request to run checks without needing to open your browser.
|
||||
|
||||
{% data variables.product.prodname_desktop %} is available for Windows and macOS. For information about installing and getting started with {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/overview/getting-started-with-github-desktop)."
|
||||
|
||||
If you're interested in the open source {% data variables.product.prodname_desktop %} project, you can see the roadmap, contribute to the project, or open an issue to provide feedback in the [`desktop/desktop`](https://github.com/desktop/desktop) repository.
|
||||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/get-started/using-git/about-git)"
|
||||
|
|
@ -5,12 +5,15 @@ intro: 'You can use {% data variables.product.prodname_desktop %} to create and
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/creating-your-first-repository-using-github-desktop
|
||||
- /desktop/installing-and-configuring-github-desktop/overview/creating-your-first-repository-using-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
## Introduction
|
||||
|
||||
{% data variables.product.prodname_desktop %} extends and simplifies your {% data variables.product.prodname_dotcom_the_website %} workflow, using a visual interface instead of text commands on the command line. By the end of this guide, you'll have used {% data variables.product.prodname_desktop %} to create a repository, make changes to the repository, and publish the changes to {% data variables.product.product_name %}.
|
||||
{% data reusables.desktop.about-github-desktop %}
|
||||
|
||||
By the end of this guide, you'll have used {% data variables.product.prodname_desktop %} to create a repository, make changes to the repository, and publish the changes to {% data variables.product.product_name %}.
|
||||
|
||||
After installing {% data variables.product.prodname_desktop %} and signing into {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %} you can create and clone a tutorial repository. The tutorial will introduce the basics of working with Git and {% data variables.product.prodname_dotcom %}, including installing a text editor, creating a branch, making a commit, pushing to {% data variables.product.prodname_dotcom_the_website %}, and opening a pull request. The tutorial is available if you do not have any repositories on {% data variables.product.prodname_desktop %} yet.
|
||||
|
||||
|
|
@ -20,7 +23,7 @@ We recommend completing the tutorial, but if you want to explore {% data variabl
|
|||
|
||||
You can install {% data variables.product.prodname_desktop %} on any supported operating system. After you install the app, you will need to sign in and authenticate your account on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %} before you can create and clone a tutorial repository.
|
||||
|
||||
For more information on installing and authenticating, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop)."
|
||||
For more information on installing and authenticating, see "[AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop)."
|
||||
|
||||
## Part 2: Creating a new repository
|
||||
|
||||
|
|
@ -51,7 +54,7 @@ If you do not wish to create and clone a tutorial repository, you can create a n
|
|||
|
||||
## Part 3: Exploring {% data variables.product.prodname_desktop %}
|
||||
|
||||
In the file menu at the top of the screen, you can access settings and actions that you can perform in {% data variables.product.prodname_desktop %}. Most actions also have keyboard shortcuts to help you work more efficiently. For a full list of keyboard shortcuts, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/github-desktop-keyboard-shortcuts)."
|
||||
In the file menu at the top of the screen, you can access settings and actions that you can perform in {% data variables.product.prodname_desktop %}. Most actions also have keyboard shortcuts to help you work more efficiently. For a full list of keyboard shortcuts, see "[AUTOTITLE](/desktop/overview/github-desktop-keyboard-shortcuts)."
|
||||
|
||||
### The {% data variables.product.prodname_desktop %} repository bar
|
||||
|
||||
|
|
@ -89,7 +92,7 @@ When you create a new repository, it only exists on your computer and you are th
|
|||
|
||||
Now that you've created and published your repository, you're ready to make changes to your project and start crafting your first commit to your repository.
|
||||
|
||||
1. To launch your external editor from within {% data variables.product.prodname_desktop %}, in the "{% data variables.product.prodname_desktop %}" menu bar, select **Repository**, then click **Open in EDITOR**. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop)."
|
||||
1. To launch your external editor from within {% data variables.product.prodname_desktop %}, in the "{% data variables.product.prodname_desktop %}" menu bar, select **Repository**, then click **Open in EDITOR**. For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop)."
|
||||
|
||||
|
||||
1. Make some changes to the _README.md_ file that you previously created. You can add information that describes your project, like what it does and why it is useful. When you are satisfied with your changes, save them in your text editor.
|
||||
|
|
@ -8,9 +8,10 @@ redirect_from:
|
|||
- /desktop/guides/getting-started
|
||||
shortTitle: Get started
|
||||
---
|
||||
|
||||
## Introduction
|
||||
|
||||
{% data variables.product.prodname_desktop %} is an application that enables you to interact with {% data variables.product.prodname_dotcom %} using a GUI instead of the command line or a web browser. {% data variables.product.prodname_desktop %} encourages you and your team to collaborate using best practices with Git and {% data variables.product.prodname_dotcom %}. You can use {% data variables.product.prodname_desktop %} to complete most Git commands from your desktop with visual confirmation of changes. You can push to, pull from, and clone remote repositories with {% data variables.product.prodname_desktop %}, and use collaborative tools such as attributing commits and creating pull requests.
|
||||
{% data reusables.desktop.about-github-desktop %}
|
||||
|
||||
This guide will help you get started with {% data variables.product.prodname_desktop %} by setting up the application, authenticating your account, configuring basic settings, and introducing the fundamentals of managing projects with {% data variables.product.prodname_desktop %}. You will be able to use {% data variables.product.prodname_desktop %} to collaborate on projects and connect to remote repositories after working through this guide.
|
||||
|
||||
|
|
@ -24,9 +25,9 @@ You might find it helpful to have a basic understanding of Git and {% data varia
|
|||
|
||||
## Part 1: Installing and authenticating
|
||||
|
||||
You can install {% data variables.product.prodname_desktop %} on any supported operating system. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/supported-operating-systems-for-github-desktop)."
|
||||
You can install {% data variables.product.prodname_desktop %} on any supported operating system. For more information, see "[AUTOTITLE](/desktop/overview/supported-operating-systems-for-github-desktop)."
|
||||
|
||||
To install {% data variables.product.prodname_desktop %}, visit the download page for [{% data variables.product.prodname_desktop %}](https://desktop.github.com/). For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop)."
|
||||
To install {% data variables.product.prodname_desktop %}, visit the download page for [{% data variables.product.prodname_desktop %}](https://desktop.github.com/). For more information, see "[AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/installing-github-desktop)."
|
||||
|
||||
After you have installed {% data variables.product.prodname_desktop %}, you can authenticate the application with your account on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}. Authenticating allows you to connect to remote repositories on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}.
|
||||
|
||||
|
|
@ -37,14 +38,14 @@ After you have installed {% data variables.product.prodname_desktop %}, you can
|
|||
1. In the "Preferences" window, on the **Accounts** pane, click one of the **Sign In** buttons to sign in to your account on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_enterprise %}.
|
||||
|
||||
|
||||
1. Follow the steps to sign in. For more information about authentication, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
1. Follow the steps to sign in. For more information about authentication, see "[AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
|
||||
{% endmac %}
|
||||
|
||||
{% windows %}
|
||||
|
||||
1. Before you can authenticate to {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, you will need an account.{% ifversion fpt or ghec %} For more information, see "[AUTOTITLE](/get-started/signing-up-for-github/signing-up-for-a-new-github-account)."{% endif %}{% ifversion ghec %} If you're part of an organization that uses {% data variables.product.prodname_emus %} and you do not have an account, contact your enterprise administrator.{% elsif ghes or ghae %} If you're a member of an organization that uses {% data variables.product.product_name %} and you do not have an account, contact your {% data variables.product.prodname_enterprise %} site administrator.{% endif %}
|
||||
1. In the File drop-down menu, click **Options**. In the options window, click **Accounts** and follow the steps to sign in. For more information on authenticating, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
1. In the File drop-down menu, click **Options**. In the options window, click **Accounts** and follow the steps to sign in. For more information on authenticating, see "[AUTOTITLE](/desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github-in-github-desktop)."
|
||||
|
||||
|
||||
{% endwindows %}
|
||||
|
|
@ -55,7 +56,7 @@ After you install {% data variables.product.prodname_desktop %}, you can configu
|
|||
|
||||
{% mac %}
|
||||
|
||||
You can connect or remove accounts on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, choose a default text editor or shell, edit your Git configuration, change the appearance of {% data variables.product.prodname_desktop %}, customize system dialog boxes, and set privacy preferences in the {% data variables.product.prodname_desktop %} Preferences window. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop)."
|
||||
You can connect or remove accounts on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, choose a default text editor or shell, edit your Git configuration, change the appearance of {% data variables.product.prodname_desktop %}, customize system dialog boxes, and set privacy preferences in the {% data variables.product.prodname_desktop %} Preferences window. For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop)."
|
||||
|
||||
|
||||
|
||||
|
|
@ -63,7 +64,7 @@ You can connect or remove accounts on {% data variables.product.prodname_dotcom
|
|||
|
||||
{% windows %}
|
||||
|
||||
You can connect or remove accounts on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, choose a default text editor or shell, edit your Git configuration, change the appearance of {% data variables.product.prodname_desktop %}, customize system dialog boxes, and set privacy preferences in the {% data variables.product.prodname_desktop %} Options window. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop)."
|
||||
You can connect or remove accounts on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}, choose a default text editor or shell, edit your Git configuration, change the appearance of {% data variables.product.prodname_desktop %}, customize system dialog boxes, and set privacy preferences in the {% data variables.product.prodname_desktop %} Options window. For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/configuring-basic-settings-in-github-desktop)."
|
||||
|
||||
|
||||
|
||||
|
|
@ -75,11 +76,11 @@ After installing, authenticating, and configuring the app, you are ready to star
|
|||
|
||||
### Creating, adding, and cloning repositories
|
||||
|
||||
You can create a new repository by selecting **File** in the "{% data variables.product.prodname_desktop %}" menu bar and clicking **New repository...**. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/creating-your-first-repository-using-github-desktop)."
|
||||
You can create a new repository by selecting **File** in the "{% data variables.product.prodname_desktop %}" menu bar and clicking **New repository...**. For more information, see "[AUTOTITLE](/desktop/overview/creating-your-first-repository-using-github-desktop)."
|
||||
|
||||
You can add a repository from your local computer by selecting **File** and clicking **Add Local Repository...**. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop)."
|
||||
You can add a repository from your local computer by selecting **File** and clicking **Add Local Repository...**. For more information, see "[AUTOTITLE](/desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop)."
|
||||
|
||||
You can clone a repository from {% data variables.product.prodname_dotcom %} by selecting **File** and clicking **Clone Repository...**. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)."
|
||||
You can clone a repository from {% data variables.product.prodname_dotcom %} by selecting **File** and clicking **Clone Repository...**. For more information, see "[AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)."
|
||||
|
||||
{% mac %}
|
||||
|
||||
|
|
@ -95,23 +96,18 @@ You can clone a repository from {% data variables.product.prodname_dotcom %} by
|
|||
|
||||
### Making changes in a branch
|
||||
|
||||
You can use {% data variables.product.prodname_desktop %} to create a branch of a project. Branches isolate your development work from other branches in the repository, so that you can safely experiment with changes. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)."
|
||||
You can use {% data variables.product.prodname_desktop %} to create a branch of a project. Branches isolate your development work from other branches in the repository, so that you can safely experiment with changes. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)."
|
||||
|
||||
After you make changes to a branch, you can review them in {% data variables.product.prodname_desktop %} and make a commit to keep track of your changes. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)."
|
||||
After you make changes to a branch, you can review them in {% data variables.product.prodname_desktop %} and make a commit to keep track of your changes. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)."
|
||||
|
||||
If you want to access your changes remotely or share them with other people, you can push your commits to {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop)."
|
||||
If you want to access your changes remotely or share them with other people, you can push your commits to {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop)."
|
||||
|
||||
### Collaborating with {% data variables.product.prodname_desktop %}
|
||||
|
||||
You can use {% data variables.product.prodname_desktop %} to create issues or pull requests to collaborate on projects with other people. Issues help you keep track of ideas and discuss possible changes to projects. Pull requests let you share your proposed changes with others, receive feedback, and merge changes into a project. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop)."''
|
||||
You can use {% data variables.product.prodname_desktop %} to create issues or pull requests to collaborate on projects with other people. Issues help you keep track of ideas and discuss possible changes to projects. Pull requests let you share your proposed changes with others, receive feedback, and merge changes into a project. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop)."''
|
||||
|
||||
You can view your own or your collaborator's pull requests in {% data variables.product.prodname_desktop %}. Viewing a pull request in {% data variables.product.prodname_desktop %} lets you see any proposed changes and make additional changes by opening the project's files and repositories in your default text editor. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop)."
|
||||
You can view your own or your collaborator's pull requests in {% data variables.product.prodname_desktop %}. Viewing a pull request in {% data variables.product.prodname_desktop %} lets you see any proposed changes and make additional changes by opening the project's files and repositories in your default text editor. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop)."
|
||||
|
||||
### Keeping your local repository in sync
|
||||
|
||||
When you make changes to your local repositories or when other people make changes to the remote repositories, you will need to sync your local copy of the project with the remote repository. {% data variables.product.prodname_desktop %} can keep your local copy of a project in sync with the remote version by pushing and pulling commits. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch-in-github-desktop)."
|
||||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop)"
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop)"
|
||||
When you make changes to your local repositories or when other people make changes to the remote repositories, you will need to sync your local copy of the project with the remote repository. {% data variables.product.prodname_desktop %} can keep your local copy of a project in sync with the remote version by pushing and pulling commits. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop)."
|
||||
|
|
@ -7,6 +7,7 @@ redirect_from:
|
|||
- /desktop/getting-started-with-github-desktop/keyboard-shortcuts
|
||||
- /desktop/installing-and-configuring-github-desktop/keyboard-shortcuts
|
||||
- /desktop/installing-and-configuring-github-desktop/overview/keyboard-shortcuts
|
||||
- /desktop/installing-and-configuring-github-desktop/overview/github-desktop-keyboard-shortcuts
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -3,9 +3,11 @@ title: Overview
|
|||
intro: Learn about GitHub Desktop and quickly create your first repository.
|
||||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/overview
|
||||
- /desktop/installing-and-configuring-github-desktop/overview
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
- /about-github-desktop
|
||||
- /getting-started-with-github-desktop
|
||||
- /creating-your-first-repository-using-github-desktop
|
||||
- /supported-operating-systems-for-github-desktop
|
||||
|
|
@ -5,6 +5,7 @@ intro: You can launch GitHub Desktop from the command line.
|
|||
redirect_from:
|
||||
- /desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line
|
||||
- /desktop/installing-and-configuring-github-desktop/launching-github-desktop-from-the-command-line
|
||||
- /desktop/installing-and-configuring-github-desktop/overview/launching-github-desktop-from-the-command-line
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -5,6 +5,7 @@ redirect_from:
|
|||
- /desktop/getting-started-with-github-desktop/supported-operating-systems
|
||||
- /desktop/installing-and-configuring-github-desktop/supported-operating-systems
|
||||
- /desktop/installing-and-configuring-github-desktop/overview/supported-operating-systems
|
||||
- /desktop/installing-and-configuring-github-desktop/overview/supported-operating-systems-for-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Supported OS
|
||||
|
|
@ -7,6 +7,7 @@ redirect_from:
|
|||
- /desktop/contributing-and-collaborating-using-github-desktop/changing-a-remotes-url-from-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/changing-a-remotes-url-from-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/changing-the-remote-url-for-a-repository-from-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/changing-the-remote-url-for-a-repository-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Change the remote URL for a repository
|
||||
|
|
@ -4,6 +4,8 @@ shortTitle: Configuring notifications
|
|||
intro: '{% data variables.product.prodname_desktop %} will keep you up-to-date with notifications about events that occur in your pull request branch.'
|
||||
versions:
|
||||
feature: desktop
|
||||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/configuring-notifications-in-github-desktop
|
||||
---
|
||||
## About notifications in {% data variables.product.prodname_desktop %}
|
||||
|
||||
|
|
@ -18,7 +20,7 @@ Clicking the notification will switch application focus to {% data variables.pro
|
|||
|
||||
When changes are made to a pull request branch, you will receive a system notification if the checks fail.
|
||||
|
||||
Clicking the notification will display a dialog with details about the checks. Once you've reviewed why the checks have failed, you can re-run the checks, or quickly switch to the pull request branch to get started on fixing the errors. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop)."
|
||||
Clicking the notification will display a dialog with details about the checks. Once you've reviewed why the checks have failed, you can re-run the checks, or quickly switch to the pull request branch to get started on fixing the errors. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop)."
|
||||
|
||||
## Notifications for pull request reviews
|
||||
|
||||
|
|
@ -7,6 +7,7 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/creating-a-pull-request
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
shortTitle: Create an issue or PR
|
||||
|
|
@ -20,9 +21,9 @@ After you create a branch and make changes to files in a project, you can create
|
|||
## Prerequisites
|
||||
|
||||
Before you create a pull request, you'll need to push changes to a branch on {% data variables.product.prodname_dotcom %}.
|
||||
- Save and commit any changes on your local branch. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)."
|
||||
- Push your local commits to the remote repository. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github)."
|
||||
- Publish your current branch to {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)."
|
||||
- Save and commit any changes on your local branch. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)."
|
||||
- Push your local commits to the remote repository. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop)."
|
||||
- Publish your current branch to {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)."
|
||||
|
||||
## Creating an issue
|
||||
|
||||
|
|
@ -3,10 +3,12 @@ title: Working with your remote repository on GitHub or GitHub Enterprise
|
|||
intro: 'As you make changes to your project locally, you can keep them up-to-date with your remote repository. In Git, a *remote* is the server where your code is stored. In your case, that server is a repository on {% data variables.product.prodname_dotcom %} or {% data variables.product.prodname_enterprise %}.'
|
||||
redirect_from:
|
||||
- /desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise
|
||||
versions:
|
||||
feature: desktop
|
||||
children:
|
||||
- /creating-an-issue-or-pull-request-from-github-desktop
|
||||
- /syncing-your-branch-in-github-desktop
|
||||
- /viewing-a-pull-request-in-github-desktop
|
||||
- /viewing-and-re-running-checks-in-github-desktop
|
||||
- /configuring-notifications-in-github-desktop
|
||||
|
|
@ -6,6 +6,8 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/syncing-your-branch
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/syncing-your-branch
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch-in-github-desktop
|
||||
- /desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -13,7 +15,7 @@ versions:
|
|||
|
||||
You can sync your local branch with the remote repository by pulling any commits that have been added to the branch on {% data variables.product.product_name %} since the last time you synced. If you make commits from another device or if multiple people contribute to a project, you will need to sync your local branch to keep the branch updated.
|
||||
|
||||
When you pull to your local branch, you only update your local copy of the repository. To update your branch on {% data variables.product.prodname_dotcom %}, you must push your changes. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github)."
|
||||
When you pull to your local branch, you only update your local copy of the repository. To update your branch on {% data variables.product.prodname_dotcom %}, you must push your changes. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop)."
|
||||
|
||||
To add changes from one branch to another branch, you can merge the branches. To apply changes to your branch from another branch in the same repository, you can merge the other branch into your branch on {% data variables.product.prodname_desktop %}. To request that changes from your branch are merged into another branch, in the same repository or in another repository in the network, you can create a pull request on {% data variables.product.prodname_desktop %}. For more information, see "[Merging another branch into your project branch](#merging-another-branch-into-your-project-branch)" and "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)."
|
||||
|
||||
|
|
@ -6,6 +6,7 @@ redirect_from:
|
|||
- /desktop/contributing-to-projects/accessing-a-pull-request-locally
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/viewing-a-pull-request-in-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-a-pull-request-in-github-desktop
|
||||
versions:
|
||||
feature: desktop
|
||||
---
|
||||
|
|
@ -61,7 +62,7 @@ If you want to look at changes in context or make additional updates to a pull r
|
|||
|
||||
|
||||
|
||||
For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop)."
|
||||
For more information, see "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop)."
|
||||
|
||||
### View the commit history
|
||||
|
||||
|
|
@ -73,11 +74,11 @@ You can view the commit history of the branch if you want to see how the contrib
|
|||
|
||||
|
||||
|
||||
For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/viewing-the-branch-history-in-github-desktop)."
|
||||
For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/viewing-the-branch-history-in-github-desktop)."
|
||||
|
||||
### View and re-run checks
|
||||
|
||||
You can view the status of checks that have run against the pull request branch. Failed checks may indicate problems with the proposed changes, which could prevent the branch from merging. You can re-run checks from {% data variables.product.prodname_desktop %}. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop#viewing-and-re-running-checks)."
|
||||
You can view the status of checks that have run against the pull request branch. Failed checks may indicate problems with the proposed changes, which could prevent the branch from merging. You can re-run checks from {% data variables.product.prodname_desktop %}. For more information, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop#viewing-and-re-running-checks)."
|
||||
|
||||
## Viewing a pull request on {% data variables.product.prodname_dotcom %}
|
||||
|
||||
|
|
@ -4,12 +4,14 @@ shortTitle: Viewing and re-running checks
|
|||
intro: 'You can view the status of checks and re-run them in {% data variables.product.prodname_desktop %}.'
|
||||
versions:
|
||||
feature: desktop
|
||||
redirect_from:
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/viewing-and-re-running-checks-in-github-desktop
|
||||
---
|
||||
## About checks in {% data variables.product.prodname_desktop %}
|
||||
|
||||
{% data variables.product.prodname_desktop %} displays the status of checks that have run in your pull request branches. The checks badge next to the branch name will display the _pending, passing,_ or _failing_ state of the checks. You can also re-run all, failed, or individual checks when viewing the status of the checks in {% data variables.product.prodname_desktop %}. For more information on setting up checks in your repository, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)."
|
||||
|
||||
{% data variables.product.prodname_desktop %} will also show a system notification when checks fail. For more information on enabling notifications, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/configuring-notifications-in-github-desktop)."
|
||||
{% data variables.product.prodname_desktop %} will also show a system notification when checks fail. For more information on enabling notifications, see "[AUTOTITLE](/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/configuring-notifications-in-github-desktop)."
|
||||
|
||||
## Viewing and re-running checks
|
||||
|
||||
|
|
@ -61,7 +61,7 @@ When you `git clone`, `git fetch`, `git pull`, or `git push` to a remote reposit
|
|||
|
||||
**Tips**:
|
||||
- You can use a credential helper so Git will remember your {% data variables.product.prodname_dotcom %} credentials every time it talks to {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/get-started/getting-started-with-git/caching-your-github-credentials-in-git)."
|
||||
- To clone a repository without authenticating to {% data variables.product.product_name %} on the command line, you can use {% data variables.product.prodname_desktop %} to clone instead. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)."
|
||||
- To clone a repository without authenticating to {% data variables.product.product_name %} on the command line, you can use {% data variables.product.prodname_desktop %} to clone instead. For more information, see "[AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)."
|
||||
|
||||
{% endtip %}
|
||||
|
||||
|
|
|
|||
|
|
@ -79,7 +79,7 @@ To best use {% data variables.product.product_name %}, you'll need to set up Git
|
|||
|
||||
If you plan to use Git locally on your computer, whether through the command line, an IDE or text editor, you will need to install and set up Git. For more information, see "[AUTOTITLE](/get-started/quickstart/set-up-git)."
|
||||
|
||||
If you prefer to use a visual interface, you can download and use {% data variables.product.prodname_desktop %}. {% data variables.product.prodname_desktop %} comes packaged with Git, so there is no need to install Git separately. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/getting-started-with-github-desktop)."
|
||||
If you prefer to use a visual interface, you can download and use {% data variables.product.prodname_desktop %}. {% data variables.product.prodname_desktop %} comes packaged with Git, so there is no need to install Git separately. For more information, see "[AUTOTITLE](/desktop/overview/getting-started-with-github-desktop)."
|
||||
|
||||
Once you install Git, you can connect to {% data variables.product.product_name %} repositories from your local computer, whether your own repository or another user's fork. When you connect to a repository on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %} from Git, you'll need to authenticate with {% data variables.product.product_name %} using either HTTPS or SSH. For more information, see "[AUTOTITLE](/get-started/getting-started-with-git/about-remote-repositories)."
|
||||
|
||||
|
|
@ -92,7 +92,7 @@ For more information about how to authenticate to {% data variables.product.prod
|
|||
| **Method** | **Description** | **Use cases** |
|
||||
| ------------- | ------------- | ------------- |
|
||||
| Browse to {% data variables.product.prodname_dotcom_the_website %} | If you don't need to work with files locally, {% data variables.product.product_name %} lets you complete most Git-related actions directly in the browser, from creating and forking repositories to editing files and opening pull requests.| This method is useful if you want a visual interface and need to do quick, simple changes that don't require working locally. |
|
||||
| {% data variables.product.prodname_desktop %} | {% data variables.product.prodname_desktop %} extends and simplifies your {% data variables.product.prodname_dotcom_the_website %} workflow, using a visual interface instead of text commands on the command line. For more information on getting started with {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/getting-started-with-github-desktop)." | This method is best if you need or want to work with files locally, but prefer using a visual interface to use Git and interact with {% data variables.product.product_name %}. |
|
||||
| {% data variables.product.prodname_desktop %} | {% data variables.product.prodname_desktop %} extends and simplifies your {% data variables.product.prodname_dotcom_the_website %} workflow, using a visual interface instead of text commands on the command line. For more information on getting started with {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/overview/getting-started-with-github-desktop)." | This method is best if you need or want to work with files locally, but prefer using a visual interface to use Git and interact with {% data variables.product.product_name %}. |
|
||||
| IDE or text editor | You can set a default text editor like [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) to open and edit your files with Git, use extensions, and view the project structure. For more information, see "[AUTOTITLE](/get-started/getting-started-with-git/associating-text-editors-with-git)." | This is convenient if you are working with more complex files and projects and want everything in one place, since text editors or IDEs often allow you to directly access the command line in the editor. |
|
||||
| Command line, with or without {% data variables.product.prodname_cli %} | For the most granular control and customization of how you use Git and interact with {% data variables.product.product_name %}, you can use the command line. For more information on using Git commands, see "[AUTOTITLE](/get-started/quickstart/git-cheatsheet)."<br/><br/> {% data variables.product.prodname_cli %} is a separate command-line tool you can install that brings pull requests, issues, {% data variables.product.prodname_actions %}, and other {% data variables.product.prodname_dotcom %} features to your terminal, so you can do all your work in one place. For more information, see "[AUTOTITLE](/github-cli/github-cli/about-github-cli)." | This is most convenient if you are already working from the command line, allowing you to avoid switching context, or if you are more comfortable using the command line. |
|
||||
| {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API | {% data variables.product.prodname_dotcom %} has a REST API and GraphQL API that you can use to interact with {% data variables.product.product_name %}. For more information, see "[AUTOTITLE](/rest/overview/about-githubs-apis)." | The {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API would be most helpful if you wanted to automate common tasks, back up your data, or create integrations that extend {% data variables.product.prodname_dotcom %}. |
|
||||
|
|
|
|||
|
|
@ -123,7 +123,7 @@ git checkout BRANCH-NAME
|
|||
|
||||
{% desktop %}
|
||||
|
||||
For more information about how to create and manage branches in {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)."
|
||||
For more information about how to create and manage branches in {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop)."
|
||||
|
||||
{% enddesktop %}
|
||||
|
||||
|
|
@ -153,7 +153,7 @@ git commit -m "a short description of the change"
|
|||
|
||||
{% desktop %}
|
||||
|
||||
For more information about how to stage and commit changes in {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#selecting-changes-to-include-in-a-commit)."
|
||||
For more information about how to stage and commit changes in {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#selecting-changes-to-include-in-a-commit)."
|
||||
|
||||
{% enddesktop %}
|
||||
|
||||
|
|
@ -179,7 +179,7 @@ git push
|
|||
|
||||
{% desktop %}
|
||||
|
||||
For more information about how to push changes in {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github)."
|
||||
For more information about how to push changes in {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop)."
|
||||
|
||||
{% enddesktop %}
|
||||
|
||||
|
|
|
|||
|
|
@ -28,7 +28,7 @@ topics:
|
|||
|
||||
To use Git on the command line, you will need to download, install, and configure Git on your computer. You can also install {% data variables.product.prodname_cli %} to use {% data variables.product.prodname_dotcom %} from the command line. For more information, see "[AUTOTITLE](/github-cli/github-cli/about-github-cli)."
|
||||
|
||||
If you want to work with Git locally, but do not want to use the command line, you can download and install the [{% data variables.product.prodname_desktop %}]({% data variables.product.desktop_link %}) client. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop)."
|
||||
If you want to work with Git locally, but do not want to use the command line, you can download and install the [{% data variables.product.prodname_desktop %}]({% data variables.product.desktop_link %}) client. For more information, see "[AUTOTITLE](/desktop/overview/about-github-desktop)."
|
||||
|
||||
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:
|
||||
|
||||
|
|
|
|||
|
|
@ -108,4 +108,4 @@ Breaking this information, from top to bottom, we see that:
|
|||
- [The "Git Branching" chapter from the _Pro Git_ book](https://git-scm.com/book/en/Git-Branching-Rebasing)
|
||||
- [The "Interactive Rebasing" chapter from the _Pro Git_ book](https://git-scm.com/book/en/Git-Tools-Rewriting-History#_changing_multiple)
|
||||
- "[Squashing commits with rebase](http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html)"
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch)" in the {% data variables.product.prodname_desktop %} documentation
|
||||
- "[AUTOTITLE](/desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch)" in the {% data variables.product.prodname_desktop %} documentation
|
||||
|
|
|
|||
|
|
@ -12,12 +12,11 @@ redirect_from:
|
|||
- /github/getting-started-with-github/github-desktop
|
||||
- /github/getting-started-with-github/using-github/github-desktop
|
||||
---
|
||||
|
||||
## About {% data variables.product.prodname_desktop %}
|
||||
|
||||
{% data reusables.desktop.about-github-desktop %}
|
||||
|
||||
For more information about {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop)" in the {% data variables.product.prodname_desktop %} documentation.
|
||||
|
||||
## Sharing feedback
|
||||
|
||||
If you have feedback or feature requests, you can open an issue in the [`desktop/desktop` repository](https://github.com/desktop/desktop).
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@ If you have source code stored locally on your computer that is tracked by Git o
|
|||
|
||||
{% note %}
|
||||
|
||||
**Note:** If you're most comfortable with a point-and-click user interface, consider adding your project with {% data variables.product.prodname_desktop %} instead. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop)."
|
||||
**Note:** If you're most comfortable with a point-and-click user interface, consider adding your project with {% data variables.product.prodname_desktop %} instead. For more information, see "[AUTOTITLE](/desktop/adding-and-cloning-repositories/adding-a-repository-from-your-local-computer-to-github-desktop)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
|
|
|||
|
|
@ -98,6 +98,6 @@ gh pr merge 523 --squash --body "my squash commit" --delete-branch
|
|||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/reverting-a-pull-request)"
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch)" using {% data variables.product.prodname_desktop %}
|
||||
- "[AUTOTITLE](/desktop/keeping-your-local-repository-in-sync-with-github/syncing-your-branch)" using {% data variables.product.prodname_desktop %}
|
||||
- "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges)"
|
||||
- "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts)"
|
||||
|
|
|
|||
|
|
@ -68,4 +68,4 @@ You can use the file tree to navigate between files in a commit.
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#about-commits)" on {% data variables.product.prodname_desktop %}
|
||||
- "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#about-commits)" on {% data variables.product.prodname_desktop %}
|
||||
|
|
|
|||
|
|
@ -34,7 +34,7 @@ For more information, see "[AUTOTITLE](/account-and-profile/setting-up-and-manag
|
|||
|
||||
## Creating co-authored commits using {% data variables.product.prodname_desktop %}
|
||||
|
||||
You can use {% data variables.product.prodname_desktop %} to create a commit with a co-author. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#write-a-commit-message-and-push-your-changes)" and [{% data variables.product.prodname_desktop %}](https://desktop.github.com).
|
||||
You can use {% data variables.product.prodname_desktop %} to create a commit with a co-author. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#write-a-commit-message-and-push-your-changes)" and [{% data variables.product.prodname_desktop %}](https://desktop.github.com).
|
||||
|
||||
## Creating co-authored commits on the command line
|
||||
|
||||
|
|
@ -87,4 +87,4 @@ The new commit and message will appear on {% data variables.location.product_loc
|
|||
- "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/why-are-my-contributions-not-showing-up-on-my-profile)"{% endif %}
|
||||
- "[AUTOTITLE](/repositories/viewing-activity-and-data-for-your-repository/viewing-a-projects-contributors)"
|
||||
- "[AUTOTITLE](/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/changing-a-commit-message)"
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#4-write-a-commit-message-and-push-your-changes)" in the {% data variables.product.prodname_desktop %} documentation
|
||||
- "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#4-write-a-commit-message-and-push-your-changes)" in the {% data variables.product.prodname_desktop %} documentation
|
||||
|
|
|
|||
|
|
@ -75,7 +75,7 @@ gh repo clone https://github.com/PATH-TO/REPOSITORY
|
|||
{% data reusables.repositories.open-with-github-desktop %}
|
||||
1. Follow the prompts in {% data variables.product.prodname_desktop %} to complete the clone.
|
||||
|
||||
For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)."
|
||||
For more information, see "[AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)."
|
||||
|
||||
{% enddesktop %}
|
||||
|
||||
|
|
|
|||
|
|
@ -120,7 +120,7 @@ As with a bare clone, a mirrored clone includes all remote branches and tags, bu
|
|||
|
||||
## Further reading
|
||||
|
||||
- "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/pushing-changes-to-github#pushing-changes-to-github)"
|
||||
- "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop)"
|
||||
- "[AUTOTITLE](/desktop/making-changes-in-a-branch/pushing-changes-to-github-from-github-desktop#pushing-changes-to-github)"
|
||||
- "[AUTOTITLE](/desktop/configuring-and-customizing-github-desktop/about-git-large-file-storage-and-github-desktop)"
|
||||
|
||||
{% endif %}
|
||||
|
|
|
|||
|
|
@ -32,7 +32,7 @@ Using {% data variables.large_files.product_name_short %}, you can store files u
|
|||
|
||||
{% data reusables.repositories.git-lfs %}
|
||||
|
||||
You can also use {% data variables.large_files.product_name_short %} with {% data variables.product.prodname_desktop %}. For more information about cloning Git LFS repositories in {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)."
|
||||
You can also use {% data variables.large_files.product_name_short %} with {% data variables.product.prodname_desktop %}. For more information about cloning Git LFS repositories in {% data variables.product.prodname_desktop %}, see "[AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop)."
|
||||
|
||||
{% data reusables.large_files.can-include-lfs-objects-archives %}
|
||||
|
||||
|
|
|
|||
|
|
@ -201,7 +201,7 @@ Additionally, if you are unable to access certain personal data we have via the
|
|||
|
||||
### Data portability
|
||||
|
||||
As a GitHub User, you can always take your data with you. You can [clone your repositories to your desktop](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop), for example, or you can use our [Data Portability tools](https://developer.github.com/changes/2018-05-24-user-migration-api/) to download information we have about you.
|
||||
As a GitHub User, you can always take your data with you. You can [clone your repositories to your desktop](/desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop), for example, or you can use our [Data Portability tools](https://developer.github.com/changes/2018-05-24-user-migration-api/) to download information we have about you.
|
||||
|
||||
### Communication preferences
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1 @@
|
|||
{% data variables.product.prodname_desktop %} is an open source tool that enables you to be more productive. {% data variables.product.prodname_desktop %} encourages you and your team to collaborate using best practices with Git and {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
Just a few of the many things you can do with {% data variables.product.prodname_desktop %} are:
|
||||
- Add changes to your commit interactively
|
||||
- Quickly add co-authors to your commit
|
||||
- Checkout branches with pull requests and view CI statuses
|
||||
- Compare changed images
|
||||
{% data variables.product.prodname_desktop %} is a free, open source application that helps you to work with code hosted on {% data variables.product.prodname_dotcom %} or other Git hosting services. With {% data variables.product.prodname_desktop %}, you can perform Git commands, such as committing and pushing changes, in a graphical user interface, rather than using the command line. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/about-github-desktop)."
|
||||
|
|
|
|||
|
|
@ -1 +1 @@
|
|||
You can use {% data variables.product.prodname_desktop %} to fork a repository. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)."
|
||||
You can use {% data variables.product.prodname_desktop %} to fork a repository. For more information, see "[AUTOTITLE](/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)."
|
||||
|
|
|
|||
|
|
@ -1,3 +1,3 @@
|
|||
If a repository has any protected branches, you can't edit or upload files in the protected branch using {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)."
|
||||
|
||||
You can use {% data variables.product.prodname_desktop %} to move your changes to a new branch and commit them. For more information, see "[AUTOTITLE](/desktop/contributing-and-collaborating-using-github-desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)."
|
||||
You can use {% data variables.product.prodname_desktop %} to move your changes to a new branch and commit them. For more information, see "[AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)."
|
||||
|
|
|
|||
|
|
@ -370,7 +370,7 @@ describe('redirects', () => {
|
|||
|
||||
describe('desktop guide', () => {
|
||||
const desktopGuide =
|
||||
'/en/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop'
|
||||
'/en/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/creating-an-issue-or-pull-request-from-github-desktop'
|
||||
|
||||
test('no language code redirects to english', async () => {
|
||||
const res = await get(
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче