diff --git a/README.md b/README.md
index d09cc8467e..5c9f9d04c0 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,16 @@
 # MusicStore application
 
-This project is part of ASP.NET 5.0. You can find samples, documentation and getting started instructions for ASP.NET 5.0 at the [Home](https://github.com/aspnet/home) repo.
+This project is part of ASP.NET 5. You can find samples, documentation and getting started instructions for ASP.NET 5 at the [Home](https://github.com/aspnet/home) repo.
 
 ## Run the application on Helios:
 * If you have Visual Studio 2015
 	1. Open MusicStore.sln in Visual Studio 2015 and run the individual applications on `IIS Express`.
 * If you don't have Visual Studio 2015
-	1. Open a command prompt and cd `\src\MusicStore\`.
+	1. Open a command prompt and execute `cd \src\MusicStore\`.
 	2. Execute `dnu restore`.
 	3. Execute `Helios.cmd` to launch the app on IISExpress from command line (Application started at URL **http://localhost:5001/**).
-	   NOTE: App and tests require Visual Studio 2015 LocalDB on the machine to run.
+	   
+**NOTE:** App and tests require Visual Studio 2015 LocalDB on the machine to run.
 
 ## Run on WebListener/Kestrel:
 * Open a command prompt and cd `\src\MusicStore\`.
@@ -21,11 +22,12 @@ This project is part of ASP.NET 5.0. You can find samples, documentation and get
 	6. Run `dnx . run` (This hosts the app in a console application - Application started at URL **http://localhost:5003/**).
 
 ## To run the sample on Mac/Mono:
-* Follow [Home](https://github.com/aspnet/home) instructions to install mono, kvm on Mac.
-* Open a command prompt and cd `\src\MusicStore\`.
+* Follow the instructions at the [Home](https://github.com/aspnet/Home) repository to install Mono and DNVM on Mac OS X.
+* Open a command prompt and execute `cd \src\MusicStore\`.
 * Execute `dnu restore`.
 * Try `dnx . kestrel` to run the application.
-**NOTE: On Mono since SQL client is not available the sample uses an InMemoryStore to run the application. So the changes that you make will not be persisted.
+
+**NOTE:** Since on Mono SQL client is not available the sample uses an InMemoryStore to run the application. So the changes that you make will not be persisted.
 
 ### Deploy on Heroku
 To deploy MusicStore on Heroku, click the button below:
@@ -33,7 +35,7 @@ To deploy MusicStore on Heroku, click the button below:
 [![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy)
 
 ###NTLM authentication
-More information at src/MusicStore/StartupNtlmAuthentication.cs.
+More information at [src/MusicStore/StartupNtlmAuthentication.cs](src/MusicStore/StartupNtlmAuthentication.cs).
 
 ###OpenIdConnect authentication
-More information at src/MusicStore/StartupOpenIdConnect.cs.
\ No newline at end of file
+More information at [src/MusicStore/StartupOpenIdConnect.cs](src/MusicStore/StartupOpenIdConnect.cs).