microsoft / Omex

Shared components used by the Omex team to build scalable and highly available distributed systems
MIT License
71 stars 40 forks source link
hacktoberfest

Microsoft OMEX

This repository contains source code for shared components used by the team, which is part of the Office organization, at Microsoft to build scalable and highly available distributed systems.

The code is released under the MIT license.

The release NuGet packages are available for download from Nuget.org

https://www.nuget.org/packages?q=omex

Additional source code from the OMEX team can be located at https://github.com/microsoft/PR-Metrics. This project is an Azure DevOps Extension and GitHub Action that augments PR titles with size and test coverage indicators.

Projects in this repository

Please contribute to this repository via pull requests against the main branch.

Build Status

Building

To build the solution you will need

Building in Visual Studio is straightforward. If you use .NET Core CLI then invoke

dotnet restore
dotnet build

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Coding Style

Please follow the pattern of what you already see in the code.

Code Overview

The code is organized in different projects, each one having its own project file. Each project produces a NuGet package. All the projects are included in the main solution file in the root directory. Please contribute to existing projects. If you would like to create a new project, please discuss this with the Team first using GitHub issues.

Documentation

All documentation is located in the ./doc folder. If you would like to contribute to the documentation, please submit a pull request.

Communicating with the Team

The easiest way to communicate with the team is via GitHub issues. Please file new issues, feature requests and suggestions.

FAQ

What is the difference between the main and release branches?

There are two types of NuGet packages that get built from the code in this repository:

Where are the NuGet packages for the components in this repository available for download?

The pre-release NuGet packages which are built from the main branch and could be published on request to Microsoft GitHub feed:

https://nuget.pkg.github.com/microsoft/index.json

The release packages are available for download from NuGet.org

https://www.nuget.org/packages?q=omex