Elaborating set-up instructions and required Visual Studio version.

README.md

@@ -7,24 +7,25 @@ author: vturecek
 # Service Fabric Getting Started Sample
 This repository contains an introductory sample project for [Microsoft Azure Service Fabric](https://azure.microsoft.com/services/service-fabric/). The sample project contains a single application with multiple services demonstrating the basic concepts needed to get you started building highly-available, scalable, distributed applications.
 
-*Looking for the older getting started samples? They're in the [classic branch](https://github.com/Azure-Samples/service-fabric-dotnet-getting-started/tree/classic).*
+ > *Looking for the older getting started samples? They're in the [classic branch](https://github.com/Azure-Samples/service-fabric-dotnet-getting-started/tree/classic).*
 
 More info on Service Fabric:
  - [Documentation](https://docs.microsoft.com/azure/service-fabric/)
  - [More sample projects](https://azure.microsoft.com/resources/samples/?service=service-fabric)
  - [Service Fabric open source home repo](https://github.com/azure/service-fabric)
 
 ## Building and deploying
-*Looking for the Visual Studio 2015 version? It's in the [vs2015 branch](https://github.com/Azure-Samples/service-fabric-dotnet-getting-started/tree/vs2015).*
 
-This sample application can be built and deployed immediately using **Visual Studio 2017**. To deploy on the local cluster, you can simply hit F5 to debug the sample. If you'd like to try publishing the sample to an Azure cluster:
+First, [set up your development environment](https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-get-started) with [Visual Studio 2017](https://www.visualstudio.com/vs/). Make sure you have at least version **15.1** of Visual Studio 2017 installed.
+
+ > *Looking for the Visual Studio 2015 version? It's in the [vs2015 branch](https://github.com/Azure-Samples/service-fabric-dotnet-getting-started/tree/vs2015).*
+
+This sample application can be built and deployed immediately using Visual Studio 2017. To deploy on the local cluster, you can simply hit F5 to debug the sample. If you'd like to try publishing the sample to an Azure cluster:
 
 1. Right-click on the application project in Solution Explorer and choose Publish.
 2. Sign-in to the Microsoft account associated with your Azure subscription.
 3. Choose the cluster you'd like to deploy to.
 
-
-
 ## About this sample application
 The sample application contains several services, each demonstrating how to use key parts of Service Fabric.