Imported Upstream version 5.0.0.42

Former-commit-id: fd56571888259555122d8a0f58c68838229cea2b

external/corefx/Documentation/project-docs/dogfooding.md

@@ -0,0 +1,99 @@
+# How to patch dotnet CLI with latest CoreFX
+
+This document provides the steps necessary to consume a nightly build of CoreFX
+and CoreCLR.
+
+Please note that these steps aren't necessary for official builds -- these steps
+are specific to consuming nightlies and thus unsupported builds. Also note that
+these steps are likely to change as we're simplifying this experience. Make
+sure to consult this document often.
+
+## Install prerequisites
+
+1. Install CLI 2.0.0-alpha SDK
+    - [Win 64-bit Latest](https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-win-x64.latest.exe)
+    - [macOS 64-bit Latest](https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-dev-osx-x64.latest.pkg)
+    - [Others](https://github.com/dotnet/cli/blob/master/README.md)
+
+## Setup the project
+
+1. Create a new project
+    - Creat a new folder for your app
+    - Create project file by running `dotnet new`
+
+2. Add the CoreFX MyGet feed to your NuGet configuration.
+    - You can do this globally but we recommend not doing this as this might
+      affect other projects on your machine and you probably don't want that.
+    - Instead, add a `nuget.config` that is local to your project. You can
+      just put it next to the `.csproj` file.
+      See the [NuGet docs](https://docs.nuget.org/ndocs/consume-packages/configuring-nuget-behavior)
+      for details.
+
+    ```xml
+    <configuration>
+      <packageSources>
+        <add key="CoreFX" value="https://dotnet.myget.org/F/dotnet-core/api/v3/index.json" />
+      </packageSources>
+    </configuration>
+    ```
+
+3. Select the nightly build from our feed
+    - <https://dotnet.myget.org/feed/dotnet-core/package/nuget/Microsoft.NETCore.App>
+    - Presumably you want the latest version.
+
+In order to consume the latest build, you'll need to update your `.csproj`
+as follows:
+
+1. Update `TargetFramework`, add `RuntimeIdentifier` as below (ideally
+   `dotnet.exe` would infer your current architecture but it currently doesn't)
+2. Update package reference to match version selected above, as below
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk" ToolsVersion="15.0">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>netcoreapp2.0</TargetFramework>
+    <RuntimeIdentifier>win10-x64</RuntimeIdentifier>
+  </PropertyGroup>
+
+  <!-- Make sure to use Update, not Include! -->
+  <ItemGroup>
+    <PackageReference Update="Microsoft.NETCore.App" Version="2.0.0-beta-001386-00" />
+  </ItemGroup>
+
+</Project>
+```
+
+Restore packages so that you're ready to play:
+
+```
+$ dotnet restore
+```
+
+## Consume the new build
+
+Edit your `Program.cs` to consume the new APIs, for example:
+
+```CSharp
+using System;
+using System.Net;
+
+class Program
+{
+    static void Main(string[] args)
+    {
+        WebUtility.HtmlDecode("&amp;", Console.Out);
+        Console.WriteLine();
+        Console.WriteLine("Hello World!");
+    }
+}
+```
+
+Run the bits:
+
+```
+$ dotnet run
+```
+
+Rinse and repeat!