Added initial docs for dotnet core

1 files changed, 35 insertions, 0 deletions

diff --git a/Documentation/DotnetCore-Bin.md b/Documentation/DotnetCore-Bin.md
new file mode 100644
index 0000000..bc4a9a5
--- /dev/null
+++ b/Documentation/DotnetCore-Bin.md
@@ -0,0 +1,35 @@
+# DotNet Core
+
+
+## Binary Packages
+
+The quickest and easiet way to install dotnet core for gentoo is to use one of the binary packages.
+
+Runtime:
+
+  * =dotnet/dotnetcore-runtime-bin-2.0.4
+  * =dotnet/dotnetcore-aspnet-bin-2.0.3
+
+SDK:
+
+  * =dotnet/dotnetcore-sdk-bin-2.1.3
+
+The SDK package (2.1.3) already includes the runtime packages (2.0.4) for dotnet core.
+The reason for including both is that the SDK is available under x64 platforms but not currently arm32 platforms (such as the Rpi)
+So for the Rpi or other arm32 platforms you'll need to use just the runtime packages unless the application your running already has the runtime build in.
+
+
+## SDK vs Runtime
+
+The SDK packages allow you to use the dotnet cli tool to compile / build C# Code into Managed Applications.
+The runtime packages allow you to use the dotnet cli tool to run pre-compiled applications.
+
+Normally when you compile a dotnet core application, you have one of two options.
+
+  * Compile it as a platform independent .dll file which doesn't include the runtime
+  * Compile it as a platform specific executable file which does include the runtime - using a runtime identifier
+
+For platform independent .dll files these require the runtime packages on the host to use the dotnet cli tool to run / call the dll to start them as an application.
+
+  * https://stackoverflow.com/questions/43931827/how-to-run-asp-net-core-on-arm-based-custom-linux
+