path: root/README.md

# .NET Core Libraries (CoreFX)

<table>
  <tr>
    <th width="9%" />
    <th width="14%">Debian 8.2</th> 
    <th width="14%">Ubuntu 14.04</th>
    <th width="14%">CentOS 7.1</th>
    <th width="14%">openSUSE 13.2</th>
    <th width="21%">Windows 10, 8, 7</th>
    <th width="14%">OS X 10.10</th>
  </tr>
  <tr>
    <td><b>Debug</b></td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_debian8.2_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_debian8.2_debug.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/debian8.2_debug_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/debian8.2_debug_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/debian8.2_debug_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/debian8.2_debug_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_ubuntu_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_ubuntu_debug.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/ubuntu_debug_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/ubuntu_debug_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/ubuntu_debug_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/ubuntu_debug_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_centos7.1_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_centos7.1_debug.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/centos7.1_debug_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/centos7.1_debug_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/centos7.1_debug_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/centos7.1_debug_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_opensuse13.2_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_opensuse13.2_debug.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/opensuse13.2_debug_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/opensuse13.2_debug_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/opensuse13.2_debug_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/opensuse13.2_debug_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/windows_nt_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/windows_nt_debug.svg?label=build+%26+test" alt="Build status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/outerloop_win10_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/outerloop_win10_debug.svg?label=win10+outer+test" alt="Outerloop Win10 status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/outerloop_windows_nt_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/outerloop_windows_nt_debug.svg?label=win8+outer+test" alt="Outerloop Win8 status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/outerloop_win7_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/outerloop_win7_debug.svg?label=win7+outer+test" alt="Outerloop Win7 status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/code_coverage_windows/Code_Coverage_Report">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/code_coverage_windows.svg?label=coverage" alt="Code coverage" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_osx_debug">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_osx_debug.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/osx_debug_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/osx_debug_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/osx_debug_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/osx_debug_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
  </tr>
  <tr>
    <td><b>Release</b></td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_debian8.2_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_debian8.2_release.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/debian8.2_release_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/debian8.2_release_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/debian8.2_release_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/debian8.2_release_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_ubuntu_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_ubuntu_release.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/ubuntu_release_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/ubuntu_release_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/ubuntu_release_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/ubuntu_release_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_centos7.1_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_centos7.1_release.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/centos7.1_release_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/centos7.1_release_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/centos7.1_release_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/centos7.1_release_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_opensuse13.2_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_opensuse13.2_release.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/opensuse13.2_release_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/opensuse13.2_release_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/opensuse13.2_release_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/opensuse13.2_release_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/windows_nt_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/windows_nt_release.svg?label=build+%26+test" alt="Build status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/outerloop_win10_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/outerloop_win10_release.svg?label=win10+outer+test" alt="Outerloop Win10 status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/outerloop_windows_nt_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/outerloop_windows_nt_release.svg?label=win8+outer+test" alt="Outerloop Win8 status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/outerloop_win7_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/outerloop_win7_release.svg?label=win7+outer+test" alt="Outerloop Win7 status" />
      </a>
    </td>
    <td>
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/nativecomp_osx_release">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/nativecomp_osx_release.svg?label=native" alt="Native status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/osx_release_bld">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/osx_release_bld.svg?label=build" alt="Managed status" />
      </a>
      <br />
      <a href="http://dotnet-ci.cloudapp.net/job/dotnet_corefx/job/osx_release_tst">
        <img src="https://img.shields.io/jenkins/s/http/dotnet-ci.cloudapp.net/job/dotnet_corefx/osx_release_tst.svg?label=test" alt="Test status" />
      </a>
    </td>
  </tr>
</table>

The corefx repo contains the library implementation (called "CoreFX") for [.NET Core](http://github.com/dotnet/core). It includes System.Collections, System.IO, System.Xml and many other [components](#net-core-library-components). You can see more information in [Documentation](Documentation/README.md). 

.NET Core is a modular implementation of .NET that can be used as the base stack for a wide variety of scenarios, today scaling from console utilities to web apps in the cloud.  You can learn more about .NET Core and how and where you can use it in the [.NET Core is open source][.NET Core oss] and [Introducing .NET Core][Introducing .NET Core] blog posts. The [.NET Core Roadmap](https://github.com/dotnet/core/blob/master/roadmap.md) describes where the team is headed.

The [.NET Core Runtime repo](https://github.com/dotnet/coreclr) contains the  runtime implementation (called "CoreCLR") for .NET Core. It includes RyuJIT, the .NET GC, native interop and many other components.

Runtime-specific library code - namely [mscorlib][mscorlib] - lives in the CoreCLR repo. It needs to be built and versioned in tandem with the runtime. The rest of CoreFX is agnostic of runtime-implementation and can be run on any compatible .NET runtime. These characteristics were the primary motivation for the 2-repo structure.

[.NET Core oss]: http://blogs.msdn.com/b/dotnet/archive/2014/11/12/net-core-is-open-source.aspx
[Introducing .NET Core]: http://blogs.msdn.com/b/dotnet/archive/2014/12/04/introducing-net-core.aspx
[mscorlib]: https://github.com/dotnet/coreclr/tree/master/src/mscorlib

## How to Engage, Contribute and Provide Feedback

Some of the best ways to contribute are to try things out, file bugs, and join in design conversations. If you are having issues with the Full .NET Framework or .NET Runtime, the best way to file a bug is at [Connect](http://connect.microsoft.com/VisualStudio) or through [Product Support](https://support.microsoft.com/en-us/contactus?ws=support) if you have a contract.

Want to get more familiar with what's going on in the code?
* [Pull requests](https://github.com/dotnet/corefx/pulls): [Open](https://github.com/dotnet/corefx/pulls?q=is%3Aopen+is%3Apr)/[Closed](https://github.com/dotnet/corefx/pulls?q=is%3Apr+is%3Aclosed)
* [![Backlog](https://cloud.githubusercontent.com/assets/1302850/6260412/38987b1e-b793-11e4-9ade-d3fef4c6bf48.png)](https://github.com/dotnet/corefx/issues?q=is%3Aopen+is%3Aissue+label%3A%220+-+Backlog%22), [![Up Next](https://cloud.githubusercontent.com/assets/1302850/6260418/4c2c7a54-b793-11e4-8ce1-a27ff5378d08.png)](https://github.com/dotnet/corefx/issues?q=is%3Aopen+is%3Aissue+label%3A%221+-+Up+Next%22) and [![In Progress](https://cloud.githubusercontent.com/assets/1302850/6260414/41b0fc30-b793-11e4-9d50-d09563cd138a.png)](https://github.com/dotnet/corefx/issues?q=is%3Aopen+is%3Aissue+label%3A%222+-+In+Progress%22) changes

Looking for something to work on? The list of [up-for-grabs issues](https://github.com/dotnet/corefx/labels/up%20for%20grabs) is a great place to start. See some of our guides for more details:

* [Contributing Guide](Documentation/project-docs/contributing.md)
* [Developer Guide](Documentation/project-docs/developer-guide.md)
* [Issue Guide](Documentation/project-docs/issue-guide.md)

We've also started to share some of our direction via more higher-level documentation, specifically:

* [Road to RTM](Documentation/project-docs/rtm.md)
* [How we triage](Documentation/project-docs/triage.md)
* [Porting to .NET Core](Documentation/project-docs/porting.md)

You are also encouraged to start a discussion by filing an issue or creating a
gist.

You can discuss .NET OSS more generally in the [.NET Foundation forums].

Want to chat with other members of the CoreFX community?

[![Join the chat at https://gitter.im/dotnet/corefx](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/dotnet/corefx?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[.NET Foundation forums]: http://forums.dotnetfoundation.org/

## .NET Core Library Components

The repo contains the source for each of the assemblies that comprises .NET Core.  Each ```Microsoft.*``` or ```System.``` folder under
[src](https://github.com/dotnet/corefx/tree/master/src) represents an individual library.  Each such folder may contain a ```ref``` folder,
which contains the source representing the "contract" or "reference assembly" for that library.  It may also contain a ```src``` folder,
which contains the source for some or all of the implementation for that library (some implementation may live in mscorlib in the 
[coreclr repo](https://github.com/dotnet/coreclr), with the build tooling generating type forwards from the library assembly to mscorlib.)  
It may also contain a ```test``` folder containing the tests associated with that library, whether the implementation source lives in corefx 
or in coreclr.

## Daily Builds

Daily builds of .NET Core components are published to [dotnet-core MyGet gallery](https://www.myget.org/gallery/dotnet-core).
The latest version number of each library can be seen in that gallery.

## License

.NET Core (including the corefx repo) is licensed under the [MIT license](LICENSE).

## .NET Foundation

.NET Core is a [.NET Foundation](http://www.dotnetfoundation.org/projects) project.

## Related Projects
There are many .NET related projects on GitHub.

- The [.NET home repo](https://github.com/Microsoft/dotnet) links to 100s of .NET projects, from Microsoft and the community.
- The [.NET Core repo](https://github.com/dotnet/core) links to .NET Core related projects from Microsoft.
- The [ASP.NET home repo](https://github.com/aspnet/home) is the best place to start learning about ASP.NET 5.
- [dotnet.github.io](http://dotnet.github.io) is a good place to discover .NET Foundation projects.