dotnet · BillWagner · Mar 20, 2017 · Mar 16, 2017 · Mar 16, 2017 · Mar 16, 2017
diff --git a/docs/core/getting-started.md b/docs/core/getting-started.md
@@ -55,3 +55,5 @@ You can get started developing .NET Core apps by following these step-by-step tu
 * [Get started with VS Code using C# and .NET Core on macOS](https://channel9.msdn.com/Blogs/dotnet/Get-started-with-VS-Code-using-CSharp-and-NET-Core-on-MacOS) - This [Channel9](https://channel9.msdn.com) video shows you how to install and use [Visual Studio Code](https://www.visualstudio.com/products/code-vs), Microsoft's lightweight cross-platform code editor, to create your first console application in .NET Core. 
 * [Getting started with .NET Core on macOS, using Visual Studio Code](tutorials/using-on-macos.md) - A tour of the steps and workflow to create a .NET Core Solution using VS Code that includes unit tests, third-party libraries and how to use the debugging tools.
 * [Getting started with .NET Core using the command-line](tutorials/using-with-xplat-cli.md) - Use any code editor with the [.NET Core cross-platform command-line interface (CLI)](tools/index.md).
+* [Getting started with .NET Core on macOS using Visual Studio for Mac](tutorials/using-on-mac-vs.md) - This tutorial shows you how to build a simple .NET Core console application using Visual Studio for Mac.
+* [Building a complete .NET Core solution on macOS using Visual Studio for Mac](tutorials/using-on-mac-vs-full-solution.md) - This tutorial shows you how to build a complete .NET Core solution that includes a reusable library and unit testing.
diff --git a/docs/core/macos-prerequisites.md b/docs/core/macos-prerequisites.md
@@ -0,0 +1,48 @@
+---
+title: Prerequisites for .NET Core on Mac | Microsoft Docs
+description: Supported macOS versions and .NET Core dependencies to develop, deploy, and run .NET Core applications on macOS machines.
+keywords: .NET, .NET Core, macOS, Mac
+author: guardrex
+ms.author: mairaw
+ms.date: 03/16/2017
+ms.topic: article
+ms.prod: .net-core
+ms.devlang: dotnet
+ms.assetid: c33b1241-ab66-4583-9eba-52cf51146f5a
+---
+
+# Prerequisites for .NET Core on Mac
+
+This article shows you the supported macOS versions and .NET Core dependencies that you need to develop, deploy, and run .NET Core applications on macOS machines. The supported OS versions and depdendencies that follow apply to the three ways of developing .NET Core apps on a Mac: via the [command-line with your favorite editor](tutorials/using-with-xplat-cli.md), [Visual Studio Code (VS Code)](https://code.visualstudio.com/), and [Visual Studio for Mac](https://www.visualstudio.com/vs/visual-studio-mac/).
+
+## Supported macOS versions
+
+.NET Core is supported by the following versions of macOS:
+
+* macOS 10.12 "Sierra"
+* macOS 10.11 "El Capitan"
+
+See the [.NET Core Release Notes](https://github.com/dotnet/core/blob/master/release-notes/1.1/1.1.md) for the complete list of supported operating systems.
+
+## .NET Core dependencies
+
+.NET Core requires OpenSSL when running on macOS. An easy way to obtain OpenSSL is by using the [Homebrew ("brew")](http://brew.sh/) package manager for macOS. After installing *brew*, install OpenSSL by executing the following commands at a Terminal (command) prompt:
+
+```Terminal
+brew update
+brew install openssl
+mkdir -p /usr/local/lib
+ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
+ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/
+```
+
+After installing OpenSSL, obtain the official [.NET Core SDK for Mac installer](https://go.microsoft.com/fwlink/?linkid=843444). .NET Core 1.1.1 is the latest version. For long-term support versions and additional downloads, visit [.NET Downloads: All downloads](https://www.microsoft.com/net/download/core). If you have problems with the installation on macOS, consult [Known issues & workarounds](https://github.com/dotnet/core/blob/master/cli/known-issues.md).
+
+## Visual Studio for Mac
+
+.NET Core development on macOS with Visual Studio for Mac requires:
+
+* A supported version of the macOS operating system
+* OpenSSL
+* .NET Core SDK for Mac
+* [Visual Studio for Mac](https://www.visualstudio.com/vs/visual-studio-mac/)
diff --git a/docs/core/tutorials/index.md b/docs/core/tutorials/index.md
@@ -30,6 +30,11 @@ The following tutorials are available for learning about .NET Core.
 - [Getting Started with C# using Visual Studio Code](../../csharp/getting-started/with-visual-studio-code.md)
 - [Getting started with .NET Core on macOS](using-on-macos.md)
 
+## Building applications with Visual Studio for Mac
+
+- [Getting started with .NET Core on macOS using Visual Studio for Mac](using-on-mac-vs.md)
+- [Building a complete .NET Core solution on macOS using Visual Studio for Mac](using-on-mac-vs-full-solution.md)
+
 ## Building applications with the .NET Core CLI tools
 
 - [Getting started with .NET Core on Windows/Linux/macOS using the .NET Core CLI tools](using-with-xplat-cli.md)

diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull01.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull01.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull02.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull02.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull03.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull03.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull03b.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull03b.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull04.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull04.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull05.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull05.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull06.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull06.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull07.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull07.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull08.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull08.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull09.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull09.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull10.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull10.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull11.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull11.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull12.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull12.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull13.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull13.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull14.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull14.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull15.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull15.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull16.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull16.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull17.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull17.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull18.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull18.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull19.png b/docs/core/tutorials/media/using-on-mac-vs-full-solution/vsmacfull19.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs/vsmac1.png b/docs/core/tutorials/media/using-on-mac-vs/vsmac1.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs/vsmac2.png b/docs/core/tutorials/media/using-on-mac-vs/vsmac2.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs/vsmac3.png b/docs/core/tutorials/media/using-on-mac-vs/vsmac3.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs/vsmac4.png b/docs/core/tutorials/media/using-on-mac-vs/vsmac4.png
diff --git a/docs/core/tutorials/media/using-on-mac-vs/vsmac5.png b/docs/core/tutorials/media/using-on-mac-vs/vsmac5.png