dotnet/README.md

# .NET Home

The dotnet repository is the starting point to engage in and learn about .NET
open source projects from [Microsoft](http://microsoft.github.io) and the
[.NET Foundation](http://dotnet.github.io). You can read the more detailed
[.NET Core is Open Source](http://blogs.msdn.com/b/dotnet/archive/2014/11/12/net-core-is-open-source.aspx)
on the .NET blog.

## Finding .NET Open Source Projects

There are many [open source .NET projects](dotnet-developer-projects.md), a few of which are listed below. Please find one to engage in or add one to the list.

* [.NET Compiler Platform ("Roslyn")](https://github.com/dotnet/roslyn)
* [.NET Core 5](https://github.com/dotnet/core)
* [ASP.NET 5](https://github.com/aspnet/home)
* [EntityFramework](https://github.com/aspnet/EntityFramework)
* [Exceptionless](https://github.com/exceptionless/Exceptionless)
* [Glimpse](http://getglimpse.com)
* [JSON.NET](http://json.net/)
* [MonoGame](http://monogame.net)
* [Mono Project](https://github.com/mono/)
* [MVVM Cross](https://github.com/MvvmCross/MvvmCross)
* [MVVM Light Toolkit](http://www.mvvmlight.net)

For a longer list, see:

* [.NET developer projects](dotnet-developer-projects.md)
* [.NET consumer projects](dotnet-consumer-projects.md) 

For a list of free services and tools for open source .NET projects, see:

* [Free Services & Tools for Open Source .NET Projects](dotnet-free-oss-services.md)

## How to Engage, Contribute and Provide Feedback

.NET open source projects from Microsoft (gladly) accept PRs and other
contributions. To contribute to ASP.NET 5 or EntityFramework, see
[the ASP.NET Contributing Guide](https://github.com/aspnet/Home/blob/master/CONTRIBUTING.md).
To contribute to .NET Core 5, see the
[.NET Core Contributing Guide](https://github.com/dotnet/corefx/wiki/Contributing).

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

Most .NET open source projects at Microsoft have been contributed to the
[.NET Foundation](http://www.dotnetfoundation.org/projects). There are two main
.NET Foundation projects for Microsoft open source projects:
[ASP.NET Core 5 project](http://www.dotnetfoundation.org/aspnet-5)
and the [.NET Core 5 project](http://www.dotnetfoundation.org/netcore5).

## License

.NET open source 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.
Initial commit 2014-10-24 06:49:41 +08:00			`# .NET Home`

Add line breaks to README.md Without some line breaks it's virtually impossible to review the diffs in any of the standard tools. 2014-10-31 10:20:29 +08:00			`The dotnet repository is the starting point to engage in and learn about .NET`
Add line breaks to README.md 2014-11-18 09:54:35 +08:00			`open source projects from [Microsoft](http://microsoft.github.io) and the`
			`[.NET Foundation](http://dotnet.github.io). You can read the more detailed`
			`[.NET Core is Open Source](http://blogs.msdn.com/b/dotnet/archive/2014/11/12/net-core-is-open-source.aspx)`
Add line breaks to README.md Without some line breaks it's virtually impossible to review the diffs in any of the standard tools. 2014-10-31 10:20:29 +08:00			`on the .NET blog.`
Add .NET Foundation text to readme.md. 2014-10-25 03:43:32 +08:00
Add reference to other .NET OSS projects and clarify relationship with Mono. 2014-10-31 11:53:54 +08:00			`## Finding .NET Open Source Projects`
Add .NET Foundation text to readme.md. 2014-10-25 03:43:32 +08:00
Simplify readme 2014-12-12 14:53:03 +08:00			`There are many [open source .NET projects](dotnet-developer-projects.md), a few of which are listed below. Please find one to engage in or add one to the list.`
Merge PR. Add separate community projects list. 2014-11-20 13:26:32 +08:00
Fixed Roslyn link in README.md 2015-01-20 03:49:54 +08:00			`* [.NET Compiler Platform ("Roslyn")](https://github.com/dotnet/roslyn)`
Merge branch 'terrajobst/readme-changes' Conflicts: README.md 2014-11-26 05:41:19 +08:00			`* [.NET Core 5](https://github.com/dotnet/core)`
Make section 'Finding .NET Open Source Projects' easier to read Most folks expected a bullet point with project references instead of a blurb of text with inline links. 2014-11-04 00:01:20 +08:00			`* [ASP.NET 5](https://github.com/aspnet/home)`
			`* [EntityFramework](https://github.com/aspnet/EntityFramework)`
Simplify readme 2014-12-12 14:53:03 +08:00			`* [Exceptionless](https://github.com/exceptionless/Exceptionless)`
			`* [Glimpse](http://getglimpse.com)`
Update link URLs in README.md 2014-11-12 14:19:22 +08:00			`* [JSON.NET](http://json.net/)`
Simplify readme 2014-12-12 14:53:03 +08:00			`* [MonoGame](http://monogame.net)`
			`* [Mono Project](https://github.com/mono/)`
Add additional community projects. Two is too few if we're going to have any. 2014-11-04 13:30:02 +08:00			`* [MVVM Cross](https://github.com/MvvmCross/MvvmCross)`
			`* [MVVM Light Toolkit](http://www.mvvmlight.net)`
Simplify readme 2014-12-12 14:53:03 +08:00
			`For a longer list, see:`

			`* [.NET developer projects](dotnet-developer-projects.md)`
			`* [.NET consumer projects](dotnet-consumer-projects.md)`
Add reference to other .NET OSS projects and clarify relationship with Mono. 2014-10-31 11:53:54 +08:00
Add free services and tools for open source .NET projects 2015-01-05 04:25:15 +08:00			`For a list of free services and tools for open source .NET projects, see:`

			`* [Free Services & Tools for Open Source .NET Projects](dotnet-free-oss-services.md)`

Accept modified PR. 2014-11-11 00:14:26 +08:00			`## How to Engage, Contribute and Provide Feedback`

Add line breaks to README.md 2014-11-18 09:54:35 +08:00			`.NET open source projects from Microsoft (gladly) accept PRs and other`
			`contributions. To contribute to ASP.NET 5 or EntityFramework, see`
			`[the ASP.NET Contributing Guide](https://github.com/aspnet/Home/blob/master/CONTRIBUTING.md).`
			`To contribute to .NET Core 5, see the`
Update links 2014-11-18 09:58:05 +08:00			`[.NET Core Contributing Guide](https://github.com/dotnet/corefx/wiki/Contributing).`
Accept modified PR. 2014-11-11 00:14:26 +08:00
Add line breaks to README.md 2014-11-18 09:54:35 +08:00			`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.`
Accept modified PR. 2014-11-11 00:14:26 +08:00
			`## .NET Foundation`

Add line breaks to README.md 2014-11-18 09:54:35 +08:00			`Most .NET open source projects at Microsoft have been contributed to the`
			`[.NET Foundation](http://www.dotnetfoundation.org/projects). There are two main`
			`.NET Foundation projects for Microsoft open source projects:`
Fix link in README. 2014-11-26 13:33:14 +08:00			`[ASP.NET Core 5 project](http://www.dotnetfoundation.org/aspnet-5)`
Fix links to ASP.NET Core 5 project and .NET Core 5 project. There are a couple broken links in the readme.md - Updated link to dotnetfoundation.org project details page in .NET Foundation section. 2014-11-13 00:34:05 +08:00			`and the [.NET Core 5 project](http://www.dotnetfoundation.org/netcore5).`
Accept modified PR. 2014-11-11 00:14:26 +08:00
			`## License`

			`.NET open source 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/).`
Fixed Roslyn link in README.md 2015-01-20 03:49:54 +08:00			`See specific projects to understand the license used.`