Merge branch 'master' into devops/build-on-2019

Author: jcansdale

docs/using/cloning-a-repository-to-visual-studio.md

@@ -2,7 +2,7 @@
 
 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 
+## Opening the clone dialog
 
 ### From **Team Explorer**
 
@@ -17,7 +17,12 @@ Next to the account you want to clone from, click **Clone**.
 
 ### From the **Start Page**
 
-Using Visual Studio 2017, click the `GitHub` button on the `Start Page` to open the clone dialog. 
+Using Visual Studio 2017, click the `GitHub` button on the `Start Page` to open the clone dialog.
+
+
+### From the **Start Window**
+
+Using Visual Studio 2019, on the `Start Window` select `Clone or check out code` and then click the `GitHub` button to open the clone dialog.
 
 
 ### From the **File** menu
@@ -26,14 +31,19 @@ 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.
+1. In the list of repositories, scroll until you find the repository you'd like to clone.
 
-![List of GitHub repositories that can be cloned inside a dialog](images/clone-dialog.png)
+You can also filter the repository results by using the *Filter* text box.
 
-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.
+In addition to using the list of personal, collaborator and organization repositories, you can enter a repository URL to clone a public repository.
 
-![List of GitHub repositories that can be cloned inside a dialog](images/clone-url-dialog.png)
+![Unified clone and open dialog](images/unified-clone-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.
+
+## Open repositories
+For any repository that you select from the list or provide a URL for that you already have cloned locally, the **Open** button becomes enabled and a message shows that you have already cloned the repository to that location.
+
+![Open option enabled in clone dialog](images/open-cloned-repository.png)

docs/using/images/clone-dialog.png

@@ -15,13 +15,19 @@ GitHub for Visual Studio provides facilities for reviewing a pull request direct
 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
+- a description of the pull request (collapsed by default)
 - 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-detail-view.png)
 
+## Viewing conversation details
+
+Click the comment count link in the GitHub pane to open up the conversation view. The conversation view shows the Pull Request description, a history of commits, and comments made.
+
+![View the conversation for a pull request](images/view-conversation.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.