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 GitHub Desktop. For more information about issues, see "About issues."
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 GitHub Desktop. For more information about pull requests, see "About pull requests."
Prerequisites
Before you create a pull request, you'll need to push changes to a branch on GitHub.
- Save and commit any changes on your local branch. For more information, see "Committing and reviewing changes to your project."
- Push your local commits to the remote repository. For more information, see "Pushing changes to GitHub."
- Publish your current branch to GitHub. For more information, see "Managing branches."
Creating an issue
- In the menu bar, use the Repository drop-down menu, then click Create Issue on GitHub.
- On GitHub, click Get started to open an issue template or click Open a blank issue.
- In the menu bar, use the Repository drop-down menu, then click Create issue on GitHub.
- On GitHub, 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, GitHub Desktop will direct you to a blank issue on GitHub.
Creating a pull request
- Switch to the branch that you want to create a pull request for. For more information, see "Switching between branches."
- Click Create Pull Request. GitHub Desktop will open your default browser to take you to GitHub.
- On GitHub, confirm that the branch in the base: drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the compare: drop-down menu is the topic branch where you made your changes.
- Type a title and description for your pull request.
- To create a pull request that is ready for review, click Create Pull Request. To create a draft pull request, use the drop-down and select Create Draft Pull Request, then click Draft Pull Request. For more information about draft pull requests, see "About pull requests."
- Switch to the branch that you want to create a pull request for. For more information, see "Switching between branches."
- Click Create Pull Request. GitHub Desktop will open your default browser to take you to GitHub.
- On GitHub, confirm that the branch in the base: drop-down menu is the branch where you want to merge your changes. Confirm that the branch in the compare: drop-down menu is the topic branch where you made your changes.
- Type a title and description for your pull request.
- To create a pull request that is ready for review, click Create Pull Request. To create a draft pull request, use the drop-down and select Create Draft Pull Request, then click Draft Pull Request. For more information about draft pull requests, see "About pull requests."
Further reading
- "Issue" in the GitHub glossary
- "Pull request" in the GitHub glossary
- "Base branch" in the GitHub glossary
- "Topic branch" in the GitHub glossary