Initial version of Mac install article

docs/getting-started/index.rst

@@ -0,0 +1,10 @@
+Getting Started
+---------------
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   getting-started/installation/*/*
+
+   

docs/getting-started/installation/installing-on-mac/installing-on-mac.rst

@@ -0,0 +1,54 @@
+Installing ASP.NET 5 On Mac OS X
+================================
+By `Steve Smith`_ | Originally Published: 1 June 2015 
+
+.. _`Steve Smith`: Author_
+
+ASP.NET 5 runs on the .NET Execution Environment (DNX), which is available on multiple platforms, including OS X. This article describes how to install DNX, and therefore ASP.NET 5, on OS X, using `Homebrew <http://brew.sh/>`_. 
+
+This article covers the following topics:
+	- Install ASP.NET 5 on OS X
+
+Install ASP.NET 5 on OS X
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+ASP.NET 5 requires DNX, which is installed and managed by the .NET Version Manager (DNVM). The DNVM is easily installed using a tool called Homebrew, which will also install the correct version of Mono for OS X.
+
+Install Homebrew
+----------------
+
+The first step is to install Homebrew if it's not already installed. This can be done from a Terminal prompt using this script:
+
+.. code-block:: console
+
+	ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+
+The installer will inform you of the steps it is taking and pause before proceeding. You can `learn more about Homebrew here <https://github.com/Homebrew/homebrew/tree/master/share/doc/homebrew#readme>`_.
+
+Install the .NET Version Manager (DNVM)
+---------------------------------------
+
+Once Homebrew is installed, install the DNVM by running ``brew tap aspnet/k`` from a Terminal window. If you need to update your version of DNVM, first run ``brew untap aspnet/k`` to delete the old commands, and then run the ``bew tap aspnet/k`` command again to get the updated scripts.
+
+Next, run the command ``brew install dnvm`` to install the .NET Version Manager. This will also automatically install the latest DNX package from the https://www.nuget.org/api/v2 feed. Run ``dnvm`` to verify that your terminal understands this command. If it does not, run the command ``source dnvm.sh`` to link it, then try running ``dnvm`` again. You should see something like this:
+
+.. image:: /_static/foo.png
+
+To install the latest version of DNX using DNVM, run: ``dnvm upgrade``
+
+Now that DNX is installed, you're ready to begin using ASP.NET 5! Now you're ready to `create a cross-platform console application <>`_ or `a simple ASP.NET MVC application that runs within DNX <>`_.
+
+Summary
+^^^^^^^
+
+ASP.NET 5 is built on the cross-platform .NET Execution Environment, which can be installed on OS X as well as Linux and Windows. Installing DNX and ASP.NET 5 on OS X takes just a few minutes, using a few Terminal commands. 
+
+Related Resources
+^^^^^^^^^^^^^^^^^
+
+`Installing ASP.NET 5 on Windows <>`_
+`Installing ASP.NET 5 on Linux <>`_
+`Your First ASP.NET 5 Application Using Visual Studio <>`_
+`Your First ASP.NET 5 Application on a Mac <>`_
+
+.. include:: /_authors/steve-smith.rst

docs/getting-started/installation/installing-on-windows/installing-on-windows.rst

@@ -0,0 +1,68 @@
+Installing ASP.NET 5 On Windows
+===============================
+By `Steve Smith`_ | Originally Published: 1 June 2015 
+
+.. _`Steve Smith`: Author_
+
+ASP.NET 5 is now available on a variety of platforms, including Windows, OS X, and Linux. This article describes how to install ASP.NET 5 on Windows, showing both standalone installation as well as installation with Visual Studio 2015. 
+
+This article covers the following topics:
+	- `Install ASP.NET with Visual Studio`_
+	- `Install ASP.NET Standalone`_
+
+Install ASP.NET with Visual Studio
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The easiest way to get started building application with ASP.NET 5 is to install the latest version of Visual Studio 2015 (including the freely available Community edition). Visual Studio is an Integrated Development Environment (IDE), which means it's not just an editor, but also many of the tools you need to build applications, in this case ASP.NET 5 web applications. When installing Visual Studio 2015, you'll want to be sure to specify that you want to install the Microsoft Web Developer Tools.
+
+.. image:: _static/web-dev-tools.png
+
+Once Visual Studio is installed, ASP.NET 5 is installed as well. You're ready to `build your first ASP.NET application </yourfirst/yourfirstaspnetapplication/yourfirstaspnetapplication>`_.
+
+Install ASP.NET Standalone
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Visual Studio isn't the only way to install ASP.NET, and installing an IDE may not be appropriate in some scenarios. You can also install ASP.NET on its own from a command prompt. There are a few steps involved, since we'll need to install and configure the environment in which ASP.NET runs, known as the .NET Execution Environment (DNX). Before installing DNX, we need one more tool, the .NET Version Manager (DNVM).
+
+Install the .NET Version Manager (DNVM)
+---------------------------------------
+
+The .NET Version Manager is used to install one or more versions of the .NET Execution Environment, and to manage which version is currently active. To install DNVM on Windows, you need to open a command prompt as an Administrator, and run the following Powershell script:
+
+.. code-block:: console
+
+	@powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/aspnet/Home/master/kvminstall.ps1'))"
+
+After the script has run, open a new command prompt and confirm DNVM is working by typing: ``dnvm``
+	
+Assuming DNVM is configured correctly, you should see a result like this:
+
+.. image:: _static/dnvm-prompt.png
+
+Install the .NET Execution Environment (DNX)
+--------------------------------------------
+
+To install the latest version of DNX using DNVM, run: ``dnvm upgrade``
+
+This command downloads the latest version of DNX and puts it on your user profile so that it is ready to use. 
+
+After this command completes, run: ``dnx`` to confirm DNX is configured correctly.
+
+.. image:: _static/dnx-installed.png
+
+Now that DNX is installed, you're ready to begin using ASP.NET 5! 
+
+Summary
+^^^^^^^
+
+You can install ASP.NET 5 on Windows either as a standalone installation, or as part of Visual Studio 2015. In either case, installation is straightforward, and once complete, you're ready to get `started building your first ASP.NET application </yourfirst/yourfirstaspnetapplication/yourfirstaspnetapplication>`_.
+
+Related Resources
+^^^^^^^^^^^^^^^^^
+
+`Installing ASP.NET 5 on OS X <>`_
+`Installing ASP.NET 5 on Linux <>`_
+`Your First ASP.NET 5 Application Using Visual Studio <>`_
+`Your First ASP.NET 5 Application on a Mac <>`_
+
+.. include:: /_authors/steve-smith.rst

docs/index.rst

@@ -15,7 +15,9 @@ Your First ASP.NET Application
    yourfirst/yourfirstaspnetapplication/yourfirstaspnetapplication
    yourfirst/fundamentalconcepts/fundamentalconcepts
    dotnetcore/introducing-dotnetcore/introducing-dotnetcore
-   
+
+.. include:: getting-started/index.rst
+ 
 ASP.NET MVC 6
 -------------