2014-11-18 02:09:08 +01:00
|
|
|
# .NET Core Home
|
|
|
|
|
|
|
|
The core repository is the starting point to engage in and learn about the
|
2016-07-19 23:10:22 +02:00
|
|
|
.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](https://github.com/dotnet/cli) - for CLI tools and questions
|
|
|
|
> * [dotnet/corefx](https://github.com/dotnet/corefx) - for API issues and questions
|
|
|
|
> * [dotnet/coreclr](https://github.com/dotnet/coreclr) - for runtime issues
|
|
|
|
> * [nuget/home](https://github.com/nuget/home) - for NuGet questions and issues
|
|
|
|
> * [aspnet/home](https://github.com/aspnet/home) - for ASP.NET Core questions and issues.
|
|
|
|
>
|
|
|
|
> We will be removing the ability to file issues on this repo in the near future.
|
2014-11-18 02:09:08 +01:00
|
|
|
|
2015-07-18 01:02:58 +02:00
|
|
|
## Get Started
|
|
|
|
|
|
|
|
If you're new to .NET Core and have 10 minutes to try it, start here:
|
2016-07-19 23:10:22 +02:00
|
|
|
- [What is .NET Core?](https://www.microsoft.com/net/core/platform)
|
2016-05-17 03:29:28 +02:00
|
|
|
- [Get Started with .NET Core on Windows, OSX and Linux](https://www.microsoft.com/net/core)
|
2015-07-18 01:02:58 +02:00
|
|
|
|
|
|
|
If you have some more time and want to go deeper:
|
2016-03-09 17:20:33 +01:00
|
|
|
- [Install ASP.NET Core on Windows, OSX and Linux](https://github.com/aspnet/home)
|
2015-04-29 23:24:16 +02:00
|
|
|
- [Install .NET Core on Windows, OSX and Linux](https://github.com/dotnet/coreclr#get-net-core)
|
|
|
|
|
2014-11-18 02:09:08 +01:00
|
|
|
## .NET Core Platform
|
|
|
|
|
|
|
|
The .NET Core platform is made of several components, which includes the
|
2015-08-28 23:39:56 +02:00
|
|
|
managed compilers, the runtime, the base class libraries, and numerous application models such as
|
2014-11-18 02:09:08 +01:00
|
|
|
ASP.NET.
|
|
|
|
|
2015-09-15 06:36:52 +02:00
|
|
|
* [Roadmap](roadmap.md)
|
2014-11-18 02:09:08 +01:00
|
|
|
* [.NET Core Framework](https://github.com/dotnet/corefx)
|
2015-04-22 22:37:15 +02:00
|
|
|
* [.NET Core Runtime](https://github.com/dotnet/coreclr)
|
2015-03-03 23:17:37 +01:00
|
|
|
* [.NET Compiler Platform ("Roslyn")](https://github.com/dotnet/roslyn)
|
2016-03-09 17:20:33 +01:00
|
|
|
* [ASP.NET Core](https://github.com/aspnet/home)
|
2014-11-18 02:09:08 +01:00
|
|
|
|
|
|
|
## How to Engage, Contribute and Provide Feedback
|
|
|
|
|
|
|
|
All projects accept contributions:
|
|
|
|
|
2016-01-27 07:52:27 +01:00
|
|
|
* [.NET Core Contributing Guide](https://github.com/dotnet/corefx/blob/master/Documentation/project-docs/contributing.md)
|
2015-03-03 23:17:37 +01:00
|
|
|
* [.NET Compiler Platform ("Roslyn")](https://github.com/dotnet/roslyn/wiki/Contributing-Code)
|
2014-11-18 02:09:08 +01:00
|
|
|
* [ASP.NET Contributing Guide](https://github.com/aspnet/Home/blob/master/CONTRIBUTING.md)
|
|
|
|
|
|
|
|
You are also encouraged to start a discussion by posting on the
|
|
|
|
[.NET Foundation Forums](http://forums.dotnetfoundation.org/) 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](http://www.dotnetfoundation.org/projects).
|
|
|
|
|
2015-07-09 23:39:06 +02:00
|
|
|
* [.NET Core Project](http://www.dotnetfoundation.org/netcore)
|
2014-11-18 02:09:08 +01:00
|
|
|
* [.NET Compiler Platform ("Roslyn" Project)](http://www.dotnetfoundation.org/dotnet-compiler-platform)
|
2016-07-01 19:57:04 +02:00
|
|
|
* [ASP.NET Core Project](http://www.dotnetfoundation.org/aspnet-core)
|
2014-11-18 02:09:08 +01:00
|
|
|
|
2015-08-28 23:39:56 +02:00
|
|
|
## Licenses
|
2014-11-18 02:09:08 +01:00
|
|
|
|
|
|
|
.NET Core platform projects typically use either the [MIT](LICENSE) or
|
|
|
|
[Apache 2](http://www.apache.org/licenses/LICENSE-2.0) licenses for code.
|
|
|
|
Some projects license documentation and other forms of content under
|
|
|
|
[Creative Commons Attribution 4.0](http://creativecommons.org/licenses/by/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
|
2015-08-28 23:39:56 +02:00
|
|
|
`String` and `List<T>`.
|
2014-11-18 02:09:08 +01:00
|
|
|
|
|
|
|
.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](https://github.com/Microsoft/referencesource)
|
|
|
|
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 (e.g. 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
|
|
|
|
|
2016-03-09 17:20:33 +01:00
|
|
|
[ASP.NET Core](https://github.com/aspnet/home) is a new cross-platform version of
|
2014-11-18 02:09:08 +01:00
|
|
|
ASP.NET that is designed for the cloud, and runs on Windows, Linux and Mac. It
|
2016-06-27 20:36:04 +02:00
|
|
|
targets .NET Core by default, but you may choose to target the .NET Framework on
|
|
|
|
Windows.
|