5.8 KiB
title, intro, permissions, redirect_from, versions, shortTitle
| title | intro | permissions | redirect_from | versions | shortTitle | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Creating an issue or pull request from GitHub Desktop | You can create an issue or pull request to propose and collaborate on changes to a repository. | Anyone can create an issue in a public repository that has issues enabled. Anyone with read permissions to a repository can create a pull request, but you must have write permissions to create a branch. |
|
|
Create an issue or PR |
About issues and pull requests
You can use issues to track ideas, bugs, tasks, and other information that's important to your project. You can create an issue in your project's repository with {% data variables.product.prodname_desktop %}. For more information about issues, see AUTOTITLE.
After you create a branch and make changes to files in a project, you can create a pull request. With a pull request, you can propose, discuss, and iterate on changes before you merge the changes into the project. You can create a pull request in your project's repository with {% data variables.product.prodname_desktop %}. For more information about pull requests, see AUTOTITLE.
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.
- Push your local commits to the remote repository. For more information, see AUTOTITLE.
- Publish your current branch to {% data variables.product.prodname_dotcom %}. For more information, see AUTOTITLE.
Creating an issue
-
In the menu bar, select Repository, then click Create Issue on {% data variables.product.prodname_dotcom %}.
{% mac %}
{% endmac %}
{% windows %}
{% endwindows %}
-
On {% data variables.product.prodname_dotcom %}, click Get started to open an issue template or click Open a blank issue.
Note
If issue templates aren't enabled in your current repository, {% data variables.product.prodname_desktop %} will direct you to a blank issue on {% data variables.product.prodname_dotcom %}.
Creating a pull request
-
Click Preview Pull Request. {% data variables.product.prodname_desktop %} will open a preview dialog showing the diff of the changes between your current branch and the base branch.
{% mac %}
{% endmac %}
{% windows %}
{% endwindows %}
Alternatively, to go straight to {% data variables.product.prodname_dotcom %} to create your pull request, select the dropdown icon and click Create Pull Request.
-
Confirm that the branch in the base: dropdown menu is the branch where you want to merge your changes.
{% data variables.product.prodname_desktop %} will advise you whether the current branch can be automatically merged into the base branch.
-
Click Create Pull Request. {% data variables.product.prodname_desktop %} will open your default browser to take you to {% data variables.product.prodname_dotcom %}.
{% data reusables.repositories.pr-title-description %} {% data reusables.repositories.create-pull-request %}
Further reading
- Issue in the {% data variables.product.prodname_dotcom %} glossary
- Pull request in the {% data variables.product.prodname_dotcom %} glossary
- Base branch in the {% data variables.product.prodname_dotcom %} glossary
- Topic branch in the {% data variables.product.prodname_dotcom %} glossary