From b79af07fbbfe10bf5eb53ff30bc2d96b496dc13d Mon Sep 17 00:00:00 2001
From: Andrew Schwartzmeyer <andschwa@microsoft.com>
Date: Wed, 30 Mar 2016 23:29:16 -0700
Subject: [PATCH] Add Linux and Windows installation instructions

---
 README.md                    | 21 ++++++-------------
 docs/installation/linux.md   | 39 ++++++++++++++++++++++++++++++++++++
 docs/installation/windows.md | 25 +++++++++++++++++++++++
 3 files changed, 70 insertions(+), 15 deletions(-)
 create mode 100644 docs/installation/linux.md
 create mode 100644 docs/installation/windows.md

diff --git a/README.md b/README.md
index 16b9903191..c0e7396183 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,10 @@ Get PowerShell
 Building summary: `Start-PSBuild` from the module
 `./PowerShellGitHubDev.psm1` (self-host on Linux / OS X)
 
+See [Linux releases](docs/installation/linux.md) and
+[Windows artifacts](docs/installation/windows.md) installation
+instructions.
+
 [releases]: https://github.com/PowerShell/PowerShell/releases
 [artifacts]: https://ci.appveyor.com/project/PowerShell/powershell-linux/build/artifacts
 
@@ -46,7 +50,8 @@ search the [issues][], and if all else fails, open a new issue.
 
 [issues]: https://github.com/PowerShell/PowerShell/issues
 
-## Obtain the source code
+Obtain the source code
+----------------------
 
 ### Setup Git
 
@@ -65,17 +70,3 @@ other repositories embedded within it as submodules. *Please* see the
 contributing guidelines and learn about submodules. Not every
 submodule is required on every system; see the individual build
 instructions for the necessary subsets.
-
-### FullCLR PowerShell
-
-## Running from CI server
-
-We publish an archive with FullCLR bits on every CI build with [AppVeyor][].
-
-* Download zip package from **artifacts** tab of the particular build.
-* Unblock zip file: right-click in file explorer -> properties -> check
-  'Unblock' checkbox -> apply
-* Extract zip file to `$bin` directory
-* `Start-DevPSGithub -binDir $bin`
-
-[appveyor]: https://ci.appveyor.com/project/PowerShell/powershell-linux
diff --git a/docs/installation/linux.md b/docs/installation/linux.md
new file mode 100644
index 0000000000..f3302dd557
--- /dev/null
+++ b/docs/installation/linux.md
@@ -0,0 +1,39 @@
+Package installation instructions
+=================================
+
+Supports Ubuntu 14.04, CentOS 7.1, and OS X 10.11.
+
+Once the package is installed, `powershell` will be in your path,
+ready to be launched from a terminal. It will read
+`~/.powershell/profile.ps1` for your user profile, and
+`/usr/local/share/powershell/PSL_profile.ps1` for the system profile.
+
+Similarly, it will search `~/.powershell/Modules` and
+`/usr/local/share/powershell/Modules` for user and system modules.
+
+Ubuntu 14.04
+============
+
+Using a stock Ubuntu 14.04 image, download the
+`powershell_0.2.0-1_amd64.deb` file, and then execute the following:
+
+```sh
+sudo apt-get install libunwind8 libicu52
+sudo dpkg -i powershell_0.2.0-1_amd64.deb
+```
+
+CentOS 7.1
+==========
+
+Using a stock CentOS 7.1 image, download the
+`powershell-0.2.0-1.x86_64.rpm` file, and then execute the following:
+
+```sh
+sudo yum install powershell-0.2.0-1.x86_64.rpm
+```
+
+OS X 10.11
+==========
+
+Using an OS X 10.11 machine, download the `powershell-0.2.0.pkg` file,
+double-click it, and follow the prompts.
diff --git a/docs/installation/windows.md b/docs/installation/windows.md
new file mode 100644
index 0000000000..a8005aadf0
--- /dev/null
+++ b/docs/installation/windows.md
@@ -0,0 +1,25 @@
+Artifact installation instructions
+==================================
+
+We publish an archive with CoreCLR and FullCLR bits on every CI build
+with [AppVeyor][].
+
+[appveyor]: https://ci.appveyor.com/project/PowerShell/powershell-linux
+
+CoreCLR artifacts
+=================
+
+* Download zip package from **artifacts** tab of the particular build.
+* Unblock zip file: right-click in file explorer -> properties ->
+  check 'Unblock' box -> apply
+* Extract zip file to `bin` directory
+* `./bin/powershell.exe`
+
+FullCLR artifacts
+=================
+
+* Download zip package from **artifacts** tab of the particular build.
+* Unblock zip file: right-click in file explorer -> properties ->
+  check 'Unblock' box -> apply
+* Extract zip file to `$in` directory
+* `Start-DevPSGithub -binDir bin`