jimmystridh / core

Home repository for .NET Core

.NET Core Home

The core repository is the starting point to engage in and learn about the .NET Core stack.

Note: please note that this repository is not for filing product issues. If you run into an issue using .NET Core, there are multiple repos where you can file an issue:

• dotnet/cli - for CLI tools and questions
• dotnet/corefx - for API issues and questions
• dotnet/coreclr - for runtime issues
• dotnet/docs - for .NET documentation issues and questions
• dotnet/sdk - for .NET Core SDK (used by Visual Studio and CLI) issues and questions
• dotnet/standard - for .NET Standard issues and questions
• nuget/home - for NuGet questions and issues
• aspnet/home - for ASP.NET Core questions and issues.
• aspnet/Docs - for ASP.NET and ASP.NET Core documentation issues and questions
• dotnet/netcorecli-fsc - for F# questions and issues

We will be removing the ability to file issues on this repo in the near future.

Get Started

If you're new to .NET Core and have 10 minutes to try it, start here:

• What is .NET Core?
• Get Started with the Official releases of .NET Core on Windows, OSX and Linux

If you have some more time and want to go deeper or get the latest builds:

• Get the latest builds of .NET Core on Windows, OSX and Linux
• Get the latest builds of ASP.NET Core on Windows, OSX and Linux

.NET Core Platform

The .NET Core platform is made of several components, which includes the managed compilers, the runtime, the base class libraries, and numerous application models such as ASP.NET.

• Roadmap
• .NET Core Framework
• .NET Core Runtime
• .NET Compiler Platform ("Roslyn")
• ASP.NET Core

How to Engage, Contribute and Provide Feedback

All projects accept contributions:

• .NET Core Contributing Guide
• .NET Compiler Platform ("Roslyn")
• ASP.NET Contributing Guide

You are also encouraged to start a discussion by posting on the .NET Foundation Forums or filing an issue in the corresponding GitHub project. See the contributing guides for more details.

.NET Foundation

The .NET Core platform is part of the .NET Foundation.

• .NET Core Project
• .NET Compiler Platform ("Roslyn" Project)
• ASP.NET Core Project

Licenses

.NET Core platform projects typically use either the MIT or Apache 2 licenses for code. Some projects license documentation and other forms of content under Creative Commons Attribution 4.0.

See specific projects to understand the license used.

Understanding the relationship between .NET Core and the .NET Framework

.NET Core and the .NET Framework have (for the most part) a subset-superset relationship. .NET Core is named "Core" since it contains the core features from the .NET Framework, for both the runtime and framework libraries. For example, .NET Core and the .NET Framework share the GC, the JIT and types such as String and List<T>.

.NET Core was created so that .NET could be open source, cross platform and be used in more resource-constrained environments. We have also published a subset of the .NET Reference Source under the MIT license, so that you and the community can port additional .NET Framework features to .NET Core.

Understanding the relationship between .NET Core and Mono

Mono is an important part of the .NET ecosystem, particularly for client scenarios (for example, Xamarin). We will look for ways to collaborate with Mono developers and encourage them to take our code to improve Mono. We will also look for opportunities to improve .NET Core with MIT-licensed Mono code.

An important collaboration opportunity is making .NET Core NuGet packages (produced from this code) work on Mono. The SIMD NuGet package is a perfect example.

Learning about ASP.NET and .NET Core

ASP.NET Core is a new cross-platform version of ASP.NET that is designed for the cloud, and runs on Windows, Linux and Mac. It targets .NET Core by default, but you may choose to target the .NET Framework on Windows.