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://www.dotnetfoundation.org/). You can read the more detailed post
[.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. Additionally [@quozd](https://github.com/quozd) maintains a list of [awesome open source .NET libraries, tools, frameworks, and software](https://github.com/quozd/awesome-dotnet). [ASP.NET Core (and .NET Core) Library and Framework Support](https://github.com/jpsingleton/ANCLAFS) is listed at [ANCLAFS.com](https://ANCLAFS.com).


* [.NET Compiler Platform ("Roslyn")](https://github.com/dotnet/roslyn)
* [.NET Core](https://github.com/dotnet/core)
* [ASP.NET Core](https://github.com/aspnet/home)
* [EntityFramework](https://github.com/aspnet/EntityFramework)
* [Orleans](https://github.com/dotnet/orleans)
* [Exceptionless](https://github.com/exceptionless/Exceptionless)
* [Glimpse](http://getglimpse.com)
* [JSON.NET](http://json.net/)
* [Mobius: C# API for Apache Spark](https://github.com/Microsoft/Mobius)
* [MonoGame](http://monogame.net)
* [Mono Project](https://github.com/mono/)
* [MVVM Cross](https://github.com/MvvmCross/MvvmCross)
* [MVVM Light Toolkit](http://www.mvvmlight.net)
* [ReactiveUI](https://github.com/reactiveui/ReactiveUI)

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 Core or Entity Framework Core, see
[the ASP.NET Contributing Guide](https://github.com/aspnet/Home/blob/master/CONTRIBUTING.md).
To contribute to .NET Core, 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 project](http://www.dotnetfoundation.org/aspnet-core)
and the [.NET Core project](http://www.dotnetfoundation.org/netcore).

## 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`
Update README.md Small fixes. I wasn't sure if we really call .NET Core as .NET Core 5, so I left as-is. 2015-11-13 11:19:52 +08:00			`[.NET Foundation](http://www.dotnetfoundation.org/). You can read the more detailed post`
Add line breaks to README.md 2014-11-18 09:54:35 +08:00			`[.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
Add ASP.NET Core Library and Framework Support (#305) Add link to ASP.NET Core (and .NET Core) Library and Framework Support GitHub repository and ANCLAFS.com. 2016-07-13 01:19:11 +08:00			`There are many [open source .NET projects](dotnet-developer-projects.md), a few of which are listed below. Additionally [@quozd](https://github.com/quozd) maintains a list of [awesome open source .NET libraries, tools, frameworks, and software](https://github.com/quozd/awesome-dotnet). [ASP.NET Core (and .NET Core) Library and Framework Support](https://github.com/jpsingleton/ANCLAFS) is listed at [ANCLAFS.com](https://ANCLAFS.com).`
added awesome-dotnet 2015-07-17 07:11:13 +08:00

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)`
Update README.md Removed .NET Core 5 references 2015-11-14 06:41:18 +08:00			`* [.NET Core](https://github.com/dotnet/core)`
Changed ASP .NET 5 to ASP .NET Core. 2016-04-06 06:03:55 +08:00			`* [ASP.NET Core](https://github.com/aspnet/home)`
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			`* [EntityFramework](https://github.com/aspnet/EntityFramework)`
Update README.md Add link to the Orleans 2015-12-24 19:44:00 +08:00			`* [Orleans](https://github.com/dotnet/orleans)`
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/)`
moving newly added entry to the correct alphabetical order 2016-04-22 01:54:23 +08:00			`* [Mobius: C# API for Apache Spark](https://github.com/Microsoft/Mobius)`
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)`
added reactiveui 2015-07-17 06:37:38 +08:00			`* [ReactiveUI](https://github.com/reactiveui/ReactiveUI)`
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`
fixed branding (#321) 2016-09-14 12:29:25 +08:00			`contributions. To contribute to ASP.NET Core or Entity Framework Core, see`
Add line breaks to README.md 2014-11-18 09:54:35 +08:00			`[the ASP.NET Contributing Guide](https://github.com/aspnet/Home/blob/master/CONTRIBUTING.md).`
Update README.md Removed .NET Core 5 references 2015-11-14 06:41:18 +08:00			`To contribute to .NET Core, 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:`
Fixed link (#304) 2016-07-13 01:18:12 +08:00			`[ASP.NET Core project](http://www.dotnetfoundation.org/aspnet-core)`
Fixed broken link 2015-07-23 17:41:51 +08:00			`and the [.NET Core project](http://www.dotnetfoundation.org/netcore).`
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.`