diff --git a/docs/contributing/cloning-a-repository-to-visual-studio.md b/docs/contributing/cloning-a-repository-to-visual-studio.md deleted file mode 100644 index 1ccea26979..0000000000 --- a/docs/contributing/cloning-a-repository-to-visual-studio.md +++ /dev/null @@ -1,19 +0,0 @@ -# Cloning a repository to Visual Studio - -After you provide your GitHub or GitHub Enterprise credentials to GitHub for Visual Studio, the extension automatically detects the personal and organization repositories you have access to on your account. - -1. Open **Team Explorer** by clicking on its tab next to *Solution Explorer*, or via the *View* menu. -2. Click the **Manage Connections** toolbar button. - -![Location of the manage connections toolbar button in Team Explorer](images/manage-connections.png) - -3. Next to the account you want to clone from, click **Clone**. - -![Clone button in the GitHub section of Team Explorer](images/clone-link.png) - -4. In the list of repositories, click the repository you'd like to clone. - -![List of GitHub repositories that can be cloned inside a dialog](images/clone-dialog.png) - -5. If desired, change the local path where the repository will be cloned into, or leave the default as-is. Click **Clone**. -6. In Team Explorer, under the list of repositories, locate the repository and double-click to open the project in Visual Studio. diff --git a/docs/contributing/creating-gists.md b/docs/contributing/creating-gists.md deleted file mode 100644 index 1a5547457b..0000000000 --- a/docs/contributing/creating-gists.md +++ /dev/null @@ -1,23 +0,0 @@ -# Creating gists - -GitHub for Visual Studio enables easy creation of gists directly from the Visual Studio Editor. - -1. [Sign in](../getting-started/authenticating-to-github.md) to GitHub. - -2. Open a file in the Visual Studio text editor. - -3. Select the section of text that you want to create a gist from. - -4. Right click and select **Create a GitHub Gist** from the **GitHub** submenu. - - ![Location of Create A GitHub Gist in the GitHub submenu](images/create-gist-menu.png) - -5. In the **Create a GitHub Gist** dialog, check that the filename is correct and optionally add a description. - - ![GitHub Gist creation dialog window](images/create-gist-dialog.png) - -6. If you want the gist to be private, check the **Private Gist** checkbox. - -7. Click **Create**. - -8. Once the gist is created it will be opened in your browser. diff --git a/docs/contributing/images/add-comment.png b/docs/contributing/images/add-comment.png deleted file mode 100644 index 3bbc5244f4..0000000000 Binary files a/docs/contributing/images/add-comment.png and /dev/null differ diff --git a/docs/contributing/images/clone-dialog.png b/docs/contributing/images/clone-dialog.png deleted file mode 100644 index 2e44a61916..0000000000 Binary files a/docs/contributing/images/clone-dialog.png and /dev/null differ diff --git a/docs/contributing/images/github-pane-toolbar.png b/docs/contributing/images/github-pane-toolbar.png deleted file mode 100644 index f146ac0b80..0000000000 Binary files a/docs/contributing/images/github-pane-toolbar.png and /dev/null differ diff --git a/docs/contributing/images/pull-request-list.png b/docs/contributing/images/pull-request-list.png deleted file mode 100644 index 9b5d32b881..0000000000 Binary files a/docs/contributing/images/pull-request-list.png and /dev/null differ diff --git a/docs/contributing/viewing-the-pull-requests-for-a-repository.md b/docs/contributing/viewing-the-pull-requests-for-a-repository.md deleted file mode 100644 index 83a2ae3e7c..0000000000 --- a/docs/contributing/viewing-the-pull-requests-for-a-repository.md +++ /dev/null @@ -1,15 +0,0 @@ -# Viewing the pull requests for a repository - -GitHub for Visual Studio exposes the pull requests for the current repository and lets you create new pull requests and review pull requests from other contributors. - -1. [Sign in](../getting-started/authenticating-to-github.md) to GitHub. -2. Open a solution in a GitHub repository. -3. Open **Team Explorer** and click the **Pull Requests** button to open the **GitHub** pane. -![Pull Requests button in the Team Explorer pane](images/pull-requests-button2.png) -4. The open pull requests will be displayed. -![Pull requests in the GitHub pane](images/pull-request-list.png) -5. Change the Open/Closed filter by clicking the **Open** link and selecting the filter you want to use from the dropdown. -6. Filter pull requests by Assignee by clicking the **Assignee** link and selecting the assignee you want to view from the dropdown. -7. Filter pull requests by Author by clicking the **Author** link and selecting the author you want to view from the dropdown. -8. Click on a pull request title to [view the pull request details and review the pull request](review-a-pull-request-in-visual-studio.md) -9. Click on the **Create New** link to [create a pull request from the current branch](sending-a-pull-request.md) diff --git a/docs/using/cloning-a-repository-to-visual-studio.md b/docs/using/cloning-a-repository-to-visual-studio.md new file mode 100644 index 0000000000..27e5cb0534 --- /dev/null +++ b/docs/using/cloning-a-repository-to-visual-studio.md @@ -0,0 +1,39 @@ +# Cloning a repository to Visual Studio + +After you provide your GitHub or GitHub Enterprise credentials to GitHub for Visual Studio, the extension automatically detects the personal, collaborator and organization repositories you have access to on your account. + +## Opening the clone dialog + +### From **Team Explorer** + +Open **Team Explorer** by clicking on its tab next to *Solution Explorer*, or via the *View* menu. +Click the **Manage Connections** toolbar button. + +![Location of the manage connections toolbar button in Team Explorer](images/manage-connections.png) + +Next to the account you want to clone from, click **Clone**. + +![Clone button in the GitHub section of Team Explorer](images/clone-link.png) + +### From the **Start Page** + +Using Visual Studio 2017, click the `GitHub` button on the `Start Page` to open the clone dialog. + + +### From the **File** menu + +Go to `File > Open > Open From GitHub...` + + +## Clone repositories +1. In the list of repositories, scroll until you find the repository you'd like to clone. You can also filter the repository results by using the *Filter* text box. + +![List of GitHub repositories that can be cloned inside a dialog](images/clone-dialog.png) + +In addition to using the list of personal, collaborator and organization repositories, you can use the URL tab to clone a public repository by its URL or using the repository owner and name. + +![List of GitHub repositories that can be cloned inside a dialog](images/clone-url-dialog.png) + +2. If desired, change the local path that the repository will be cloned into, or leave the default as-is. +3. Once a repository is selected and the path is set, Click **Clone**. +4. In Team Explorer, under the list of solutions, double-click on a solution to open it in Visual Studio. diff --git a/docs/contributing/creating-a-pull-request.md b/docs/using/creating-a-pull-request.md similarity index 100% rename from docs/contributing/creating-a-pull-request.md rename to docs/using/creating-a-pull-request.md diff --git a/docs/contributing/creating-an-empty-repository-from-visual-studio.md b/docs/using/creating-an-empty-repository-from-visual-studio.md similarity index 100% rename from docs/contributing/creating-an-empty-repository-from-visual-studio.md rename to docs/using/creating-an-empty-repository-from-visual-studio.md diff --git a/docs/using/creating-gists.md b/docs/using/creating-gists.md new file mode 100644 index 0000000000..ec2faee3fd --- /dev/null +++ b/docs/using/creating-gists.md @@ -0,0 +1,26 @@ +# Creating gists + +With GitHub for Visual Studio, you can easily create gists directly from the editor. + +1. [Sign in](../getting-started/authenticating-to-github.md) to GitHub. + +2. Open a file in the Visual Studio text editor. + +3. Select the section of text that you want to create a gist from. + +4. Right click and select **Create a GitHub Gist** from the **GitHub** submenu to create the gist on GitHub. + + ![Location of Create a GitHub Gist in the GitHub submenu](images/create-github-gist-menu.png) + +5. To create the gist on GitHub Enterprise select **Create an Enterprise Gist** option from the submenu. + ![Location of Create a Enterprise Gist in the GitHub submenu](images/create-enterprise-gist-menu.png) + +6. In the **Create a GitHub Gist** dialog, check that the filename is correct and optionally add a description. + + ![GitHub Gist creation dialog window](images/create-gist-dialog.png) + +7. If you want the gist to be private, check the **Private Gist** checkbox. + +8. Click **Create**. + +9. Once the gist is created it will be opened in your browser. diff --git a/docs/using/images/add-review-comment.png b/docs/using/images/add-review-comment.png new file mode 100644 index 0000000000..342a90b744 Binary files /dev/null and b/docs/using/images/add-review-comment.png differ diff --git a/docs/using/images/add-review.png b/docs/using/images/add-review.png new file mode 100644 index 0000000000..2ee0f94627 Binary files /dev/null and b/docs/using/images/add-review.png differ diff --git a/docs/contributing/images/add-to-source-control.png b/docs/using/images/add-to-source-control.png similarity index 100% rename from docs/contributing/images/add-to-source-control.png rename to docs/using/images/add-to-source-control.png diff --git a/docs/using/images/clone-dialog.png b/docs/using/images/clone-dialog.png new file mode 100644 index 0000000000..43d44666ee Binary files /dev/null and b/docs/using/images/clone-dialog.png differ diff --git a/docs/contributing/images/clone-link.png b/docs/using/images/clone-link.png similarity index 100% rename from docs/contributing/images/clone-link.png rename to docs/using/images/clone-link.png diff --git a/docs/using/images/clone-url-dialog.png b/docs/using/images/clone-url-dialog.png new file mode 100644 index 0000000000..99c490e978 Binary files /dev/null and b/docs/using/images/clone-url-dialog.png differ diff --git a/docs/using/images/continue-your-review.png b/docs/using/images/continue-your-review.png new file mode 100644 index 0000000000..fa5af830c1 Binary files /dev/null and b/docs/using/images/continue-your-review.png differ diff --git a/docs/contributing/images/create-dialog.png b/docs/using/images/create-dialog.png similarity index 100% rename from docs/contributing/images/create-dialog.png rename to docs/using/images/create-dialog.png diff --git a/docs/using/images/create-enterprise-gist-menu.png b/docs/using/images/create-enterprise-gist-menu.png new file mode 100644 index 0000000000..07a9640ae4 Binary files /dev/null and b/docs/using/images/create-enterprise-gist-menu.png differ diff --git a/docs/contributing/images/create-gist-dialog.png b/docs/using/images/create-gist-dialog.png similarity index 100% rename from docs/contributing/images/create-gist-dialog.png rename to docs/using/images/create-gist-dialog.png diff --git a/docs/contributing/images/create-gist-menu.png b/docs/using/images/create-gist-menu.png similarity index 100% rename from docs/contributing/images/create-gist-menu.png rename to docs/using/images/create-gist-menu.png diff --git a/docs/using/images/create-github-gist-menu.png b/docs/using/images/create-github-gist-menu.png new file mode 100644 index 0000000000..16a5fab586 Binary files /dev/null and b/docs/using/images/create-github-gist-menu.png differ diff --git a/docs/contributing/images/create-link.png b/docs/using/images/create-link.png similarity index 100% rename from docs/contributing/images/create-link.png rename to docs/using/images/create-link.png diff --git a/docs/using/images/delete-comment.png b/docs/using/images/delete-comment.png new file mode 100644 index 0000000000..6a9d8c7fe7 Binary files /dev/null and b/docs/using/images/delete-comment.png differ diff --git a/docs/using/images/edit-comment.png b/docs/using/images/edit-comment.png new file mode 100644 index 0000000000..a73c6fab20 Binary files /dev/null and b/docs/using/images/edit-comment.png differ diff --git a/docs/using/images/github-pane-toolbar.png b/docs/using/images/github-pane-toolbar.png new file mode 100644 index 0000000000..3eb6b4c795 Binary files /dev/null and b/docs/using/images/github-pane-toolbar.png differ diff --git a/docs/contributing/images/hover-to-add-comment.png b/docs/using/images/hover-to-add-comment.png similarity index 100% rename from docs/contributing/images/hover-to-add-comment.png rename to docs/using/images/hover-to-add-comment.png diff --git a/docs/contributing/images/manage-connections.png b/docs/using/images/manage-connections.png similarity index 100% rename from docs/contributing/images/manage-connections.png rename to docs/using/images/manage-connections.png diff --git a/docs/contributing/images/open-on-github.png b/docs/using/images/open-on-github.png similarity index 100% rename from docs/contributing/images/open-on-github.png rename to docs/using/images/open-on-github.png diff --git a/docs/contributing/images/open-team-explorer.png b/docs/using/images/open-team-explorer.png similarity index 100% rename from docs/contributing/images/open-team-explorer.png rename to docs/using/images/open-team-explorer.png diff --git a/docs/using/images/pending-review-comment.png b/docs/using/images/pending-review-comment.png new file mode 100644 index 0000000000..328144ee70 Binary files /dev/null and b/docs/using/images/pending-review-comment.png differ diff --git a/docs/contributing/images/pr-create.png b/docs/using/images/pr-create.png similarity index 100% rename from docs/contributing/images/pr-create.png rename to docs/using/images/pr-create.png diff --git a/docs/using/images/pr-detail-view-checkout-branch.png b/docs/using/images/pr-detail-view-checkout-branch.png new file mode 100644 index 0000000000..55f63aacc9 Binary files /dev/null and b/docs/using/images/pr-detail-view-checkout-branch.png differ diff --git a/docs/using/images/pr-detail-view.png b/docs/using/images/pr-detail-view.png new file mode 100644 index 0000000000..23b4739a58 Binary files /dev/null and b/docs/using/images/pr-detail-view.png differ diff --git a/docs/contributing/images/pr-details-checkout-link.png b/docs/using/images/pr-details-checkout-link.png similarity index 100% rename from docs/contributing/images/pr-details-checkout-link.png rename to docs/using/images/pr-details-checkout-link.png diff --git a/docs/contributing/images/pr-details.png b/docs/using/images/pr-details.png similarity index 100% rename from docs/contributing/images/pr-details.png rename to docs/using/images/pr-details.png diff --git a/docs/contributing/images/pr-diff-files.png b/docs/using/images/pr-diff-files.png similarity index 100% rename from docs/contributing/images/pr-diff-files.png rename to docs/using/images/pr-diff-files.png diff --git a/docs/contributing/images/pr-pull-changes.png b/docs/using/images/pr-pull-changes.png similarity index 100% rename from docs/contributing/images/pr-pull-changes.png rename to docs/using/images/pr-pull-changes.png diff --git a/docs/contributing/images/publish-to-github.png b/docs/using/images/publish-to-github.png similarity index 100% rename from docs/contributing/images/publish-to-github.png rename to docs/using/images/publish-to-github.png diff --git a/docs/using/images/pull-request-assignable-user.png b/docs/using/images/pull-request-assignable-user.png new file mode 100644 index 0000000000..f0e48efc52 Binary files /dev/null and b/docs/using/images/pull-request-assignable-user.png differ diff --git a/docs/using/images/pull-request-list-filter.png b/docs/using/images/pull-request-list-filter.png new file mode 100644 index 0000000000..5dd960c4c8 Binary files /dev/null and b/docs/using/images/pull-request-list-filter.png differ diff --git a/docs/using/images/pull-request-list-view.png b/docs/using/images/pull-request-list-view.png new file mode 100644 index 0000000000..38678b8ab9 Binary files /dev/null and b/docs/using/images/pull-request-list-view.png differ diff --git a/docs/contributing/images/pull-requests-button.png b/docs/using/images/pull-requests-button.png similarity index 100% rename from docs/contributing/images/pull-requests-button.png rename to docs/using/images/pull-requests-button.png diff --git a/docs/contributing/images/pull-requests-button2.png b/docs/using/images/pull-requests-button2.png similarity index 100% rename from docs/contributing/images/pull-requests-button2.png rename to docs/using/images/pull-requests-button2.png diff --git a/docs/using/images/single-comment.png b/docs/using/images/single-comment.png new file mode 100644 index 0000000000..178d24ad39 Binary files /dev/null and b/docs/using/images/single-comment.png differ diff --git a/docs/using/images/submit-review-options.png b/docs/using/images/submit-review-options.png new file mode 100644 index 0000000000..d6fb4c2521 Binary files /dev/null and b/docs/using/images/submit-review-options.png differ diff --git a/docs/using/images/submit-review.png b/docs/using/images/submit-review.png new file mode 100644 index 0000000000..207e9d52ae Binary files /dev/null and b/docs/using/images/submit-review.png differ diff --git a/docs/contributing/images/successful-creation-message.png b/docs/using/images/successful-creation-message.png similarity index 100% rename from docs/contributing/images/successful-creation-message.png rename to docs/using/images/successful-creation-message.png diff --git a/docs/contributing/images/team-explorer-sync.png b/docs/using/images/team-explorer-sync.png similarity index 100% rename from docs/contributing/images/team-explorer-sync.png rename to docs/using/images/team-explorer-sync.png diff --git a/docs/contributing/index.md b/docs/using/index.md similarity index 100% rename from docs/contributing/index.md rename to docs/using/index.md diff --git a/docs/contributing/making-changes-to-a-pull-request.md b/docs/using/making-changes-to-a-pull-request.md similarity index 100% rename from docs/contributing/making-changes-to-a-pull-request.md rename to docs/using/making-changes-to-a-pull-request.md diff --git a/docs/contributing/publishing-an-existing-project-to-github.md b/docs/using/publishing-an-existing-project-to-github.md similarity index 100% rename from docs/contributing/publishing-an-existing-project-to-github.md rename to docs/using/publishing-an-existing-project-to-github.md diff --git a/docs/contributing/reviewing-a-pull-request-in-visual-studio.md b/docs/using/reviewing-a-pull-request-in-visual-studio.md similarity index 57% rename from docs/contributing/reviewing-a-pull-request-in-visual-studio.md rename to docs/using/reviewing-a-pull-request-in-visual-studio.md index 904af9dab3..89bf3beb81 100644 --- a/docs/contributing/reviewing-a-pull-request-in-visual-studio.md +++ b/docs/using/reviewing-a-pull-request-in-visual-studio.md @@ -12,15 +12,21 @@ GitHub for Visual Studio provides facilities for reviewing a pull request direct ## Viewing a pull request -The Pull Request Details view shows the current state of the pull request, including information about who created the pull request, the source and target branch, and the files changed. +The Pull Request Details view shows the current state of the pull request, including: +- information about who created the pull request +- the source and target branch +- a description of the pull request +- reviewers and the status of their review +- checks (if checks have been enabled for the repository) +- the files changed -![The details of a single pull request in the GitHub pane](images/pr-details.png) +![The details of a single pull request in the GitHub pane](images/pr-detail-view.png) ## Checking out a pull request To check out the pull request branch, click the **Checkout [branch]** link where [branch] is the name of the branch that will be checked out. -![Location of the checkout link in the GitHub pull request details page](images/pr-details-checkout-link.png) +![Location of the checkout link in the GitHub pull request details page](images/pr-detail-view-checkout-branch.png) If the pull request is from a fork then a remote will be added to the forked repository and the branch checked out locally. This remote will automatically be cleaned up when the local branch is deleted. @@ -46,6 +52,45 @@ You can add comments to a pull request directly from Visual Studio. When a file ![Hover over margin to see add comment icon](images/hover-to-add-comment.png) Then click the icon on the desired line and leave a comment. -![Add a comment](images/add-comment.png) +![Add a comment](images/add-review-comment.png) -Existing comments left by you or other reviewers will also show up in this margin. Click the icon to open an inline conversation view from which you can review and reply to comments: +To just comment on this one line, select **Add a single comment**. This will add the comment immediately. + +To start a review of the Pull Request and all its changes, select **Start a review**. This will add this comment as pending, and the comment will be submitted once the review is complete. + +#### Viewing comments + +Existing comments left by you or other reviewers will also show up in this margin. Click the icon to open an inline conversation view from which you can review and reply to comments. + +Single comments appear like this when viewed inline. +![Single comment](images/single-comment.png) + +Review comments appear the same as single comments except for a Pending badge is added to the comment. +![Single comment](images/pending-review-comment.png) + +#### Modifying Comments + +Single and review comments can either be edited or deleted. + +To edit a comment, press the pencil symbol to edit the comment and then select **Update comment** once finished. +![Edit comment](images/edit-comment.png) + +To delete a comment, press the x symbol. A confirmation box to delete the comment will appear. +![Delete comment](images/delete-comment.png) + +#### Submitting a review + +From the pull request details view you can go to the review summary and submit a review. + +If you have pending review comments you'll see the option **Continue your review**: +![Continue review](images/continue-your-review.png) + +Otherwise you'll see an option to **Add your review**: + +![Add review](images/add-review.png) + +When you are redirected to the review summary view, leave a review summary and select **Submit review**. +![Submit review](images/submit-review.png) + +The options available are to **Approve**, **Comment only** or **Request changes**. +![Submit review options](images/submit-review-options.png) diff --git a/docs/contributing/using-the-github-toolbar.md b/docs/using/using-the-github-toolbar.md similarity index 100% rename from docs/contributing/using-the-github-toolbar.md rename to docs/using/using-the-github-toolbar.md diff --git a/docs/contributing/viewing-code-on-github.md b/docs/using/viewing-code-on-github.md similarity index 100% rename from docs/contributing/viewing-code-on-github.md rename to docs/using/viewing-code-on-github.md diff --git a/docs/using/viewing-the-pull-requests-for-a-repository.md b/docs/using/viewing-the-pull-requests-for-a-repository.md new file mode 100644 index 0000000000..eea77c6fc3 --- /dev/null +++ b/docs/using/viewing-the-pull-requests-for-a-repository.md @@ -0,0 +1,16 @@ +# Viewing the pull requests for a repository + +GitHub for Visual Studio exposes the pull requests for the current repository and lets you create new pull requests and review pull requests from other contributors. + +1. [Sign in](../getting-started/authenticating-to-github.md) to GitHub. +2. Open a solution in a GitHub repository. +3. Open **Team Explorer** and click the **Pull Requests** button to open the **GitHub** pane. +![Pull Requests button in the Team Explorer pane](images/pull-requests-button2.png) +4. The open pull requests will be displayed. +![Pull requests in the GitHub pane](images/pull-request-list-view.png) +5. Change the pull requests listed by clicking the **Open** link and selecting the filter you want to use from the dropdown with the options *Open/Closed/All*. +![Pull requests status dropdown filter](images/pull-request-list-filter.png) +6. Filter pull requests by author by clicking the person icon and selecting the user you want to view from the dropdown. You can also search for users from the dropdown. +![Pull requests assignable user dropdown filter](images/pull-request-assignable-user.png) +7. Double-click anywhere in the pull request item to [view the pull request details and review the pull request](reviewing-a-pull-request-in-visual-studio.md) +8. Click on the **Create New** link to [create a pull request from the current branch](creating-a-pull-request.md)