diff --git a/02.-Setting-eShopOnContainers-in-a-Visual-Studio-2017-environment.md b/02.-Setting-eShopOnContainers-in-a-Visual-Studio-2017-environment.md
index ccefb38..21b19f8 100644
--- a/02.-Setting-eShopOnContainers-in-a-Visual-Studio-2017-environment.md
+++ b/02.-Setting-eShopOnContainers-in-a-Visual-Studio-2017-environment.md
@@ -1,9 +1,10 @@
 ## Want to try it out from Visual Studio 2017?
 
-### IMPORTANT NOTE!
-**Visual Studio 2017 15.7 Preview 2.0 or later is needed to run the solution from the *DEV branch* (current evolving code) which now includes API Gateways features**. Due to the configuration used in `docker-compose.yml` file, VS 15.7 (currently in Preview 2) is needed to run the solution at DEV branch or you can also run eShopOnContainers with Docker CLI with "docker-compose up" or deploying to Kubernetes/AKS. Trying to run the solution in VS15.6 (current RTM of Visual Studio 2017) will generate errors (complaining about invalid values in docker-compose file).
+## IMPORTANT NOTE ON VISUAL STUDIO 2017 VERSION NEEDED!
+**Visual Studio 2017 15.7 Preview 2.0 or later is needed to run the solution from the *[DEV branch](https://github.com/dotnet-architecture/eShopOnContainers/tree/dev)* (current evolving code) which now includes API Gateways features**. Due to the configuration used in `docker-compose.yml` file, VS 15.7 (currently in Preview 2) is needed to run the solution at [DEV branch](https://github.com/dotnet-architecture/eShopOnContainers/tree/dev) or you can also run eShopOnContainers with Docker CLI with *"docker-compose up"* or deploying to *Kubernetes/AKS*. 
+Trying to run the solution at [DEV branch](https://github.com/dotnet-architecture/eShopOnContainers/tree/dev) in VS 15.6 (current RTM of Visual Studio 2017) will generate errors (complaining about invalid values in docker-compose file).
 
-If you want/need to run eShopOnContainers in **Visual Studio 2017 15.6 RTM** or previous, you'll need to use the code at the **MASTER branch** which is the previous stable version of eShopOnContainers.
+If you want/need to run eShopOnContainers in **Visual Studio 2017 15.6 RTM** or previous, you'll need to use the code at the **[MASTER branch](https://github.com/dotnet-architecture/eShopOnContainers/tree/master)** which is the previous stable version of eShopOnContainers.
  
 Main steps to run it in Visual Studio: