libraries

.NET Libraries

This folder contains the source and tests for the .NET Libraries. Different libraries are owned by different team members; refer to the Areas list for lead and owner information.

Contribution Bar

Some libraries are under more active development than others. Depending on the library's status, expectations for issues and pull requests can vary. Check the library's folder for a README.md that declares the contribution bar for that library which consists of a Primary bar and optional Secondary bars. Regardless of a library's contribution bar, refer to the DOs and DON'Ts and Suggested Workflow in our contribution guidelines before submitting a pull request.

Assumed bars (unless a library says otherwise)

• We consider security fixes
• We consider test coverage changes
• We don't accept style-only changes

Primary bar

• We consider new features, new APIs and performance changes
  • Both features and fixes will be considered when aligned with current efforts
    • For new APIs, please follow the API Review Process
  • Performance gains are welcome. Update benchmarks as appropriate
  • Refactoring changes are welcome
• We only consider fixes to maintain or improve quality
  • New features and APIs are not normally accepted but there are exceptions such as when responding to runtime changes or language additions
  • The library is likely mature and feature-complete but may be extended occasionally
  • Performance gains are considered if they are lower-risk or high-impact
  • Refactoring changes are considered if there is a clear benefit
• We only consider lower-risk or high-impact fixes to maintain or improve quality
  • New features and APIs are not accepted
  • We don't accept potentially destabilizing fixes or test changes unless there is a clear need
• We only consider fixes that unblock critical issues
  • New features and APIs are not accepted
  • Infrastructure changes and other non-functional changes are considered

Secondary bars

• We consider PRs that target this library for new source code analyzers
• We don't accept refactoring changes due to new language features

Deployment

Some libraries are included in the .NET SDK as part of the runtime's shared framework. Other libraries are deployed as out-of-band (OOB) NuGet packages and need to be installed separately.

For more information, see the Runtime libraries overview.