diff --git a/docs/building/linux.md b/docs/building/linux.md
index 130e104b72..9e1346d338 100644
--- a/docs/building/linux.md
+++ b/docs/building/linux.md
@@ -7,8 +7,9 @@ start by showing how to set up your environment from scratch.
 Environment
 ===========
 
-These instructions are written assuming the Ubuntu 14.04 LTS, since
-that's the distro the team uses.
+These instructions are written assuming the Ubuntu 14.04 LTS, since that's the
+distro the team uses. The build module works on a best-effort basis for other
+distributions.
 
 Git Setup
 ---------
@@ -74,8 +75,11 @@ The `Start-PSBootstrap` function does the following:
 - Adds the LLVM package feed
 - Installs our dependencies combined with the dependencies of the .NET
   CLI toolchain via `apt-get`
-- Installs the .NET CLI host, shared framework, and SDK by downloading
-  the three `.deb` packages and using `dpkg -i`
+- Uninstalls any prior versions of .NET CLI
+- Downloads and installs the latest .NET CLI 1.0.0-preview2 SDK to `~/.dotnet`
+
+If you want to use `dotnet` outside of `Start-PSBuild`, add `~/.dotnet` to your
+`PATH` environment variable.
 
 [dotnet-cli]: https://github.com/dotnet/cli#new-to-net-cli
 [CMake]: https://cmake.org/cmake/help/v2.8.12/cmake.html
diff --git a/docs/building/osx.md b/docs/building/osx.md
index 112fddda90..8ed403dbe5 100644
--- a/docs/building/osx.md
+++ b/docs/building/osx.md
@@ -20,12 +20,12 @@ install a self-hosted copy of PowerShell on your OS X machine, and use
 The `Start-PSBootstrap` function does the following:
 
 - Uses `brew` to install CMake, OpenSSL, and GNU WGet
-- Downloads and installs the latest .NET CLI package
-- Adds `/usr/local/share/dotnet` to the process path
+- Links OpenSSL
+- Uninstalls any prior versions of .NET CLI
+- Downloads and installs the latest .NET CLI 1.0.0-preview2 SDK to `~/.dotnet`
 
-Please heed that last step. You may want to add the .NET CLI tool
-location to your path more permanently by adding it to your shell's
-profile.
+If you want to use `dotnet` outside of `Start-PSBuild`, add `~/.dotnet` to your
+`PATH` environment variable.
 
 error: Too many open files
 --------------------------