mirror of
https://github.com/saymrwulf/onnxruntime.git
synced 2026-07-10 17:37:14 +00:00
User/alexzak/win ml principles (#5453)
* Contributing page change * Update WinML_principles.md * Update WinML_principles.md * Update WinML_principles.md * Updated * Update WinML_principles.md * Update WinML_principles.md * Update WinML_principles.md
This commit is contained in:
parent
62a99824cb
commit
8bae883d3e
2 changed files with 36 additions and 5 deletions
|
|
@ -6,6 +6,8 @@ Start by reading the [Engineering Design](./docs/InferenceHighLevelDesign.md). Y
|
|||
## Proposing new public APIs
|
||||
|
||||
ONNX Runtime has a collection of [public APIs](./README.md#api-documentation). Some of these APIs make their way back into the Windows OS. We make compatibility commitments for these APIs and follow a structured process when adding to them. Please use the [Feature Request issue template](https://github.com/microsoft/onnxruntime/issues/new?template=feature_request.md) before starting any PRs that affect any of the public APIs.
|
||||
|
||||
If your proposal contributes the Windows Machine Learning WinRT API and will affect the Windows.AI.MachineLearning namespace, please review [Windows ML main principles](./docs/WinML_principles.md) before you submit your request.
|
||||
|
||||
## Process details
|
||||
|
||||
|
|
@ -23,12 +25,9 @@ Note that if an issue isn't a high priority or has many open questions then it m
|
|||
The ONNX Runtime team will review the proposal and either approve or close the issue based on whether it broadly aligns with the [Onnx Runtime Roadmap - High Level Goals section](./docs/Roadmap.md) and contribution guidelines.
|
||||
|
||||
4. **API Review**
|
||||
If the feature adds new APIs then we'll start an API review.
|
||||
All new public APIs must be reviewed before merging.
|
||||
For making changes to the C API refer to guidance [here](onnxruntime/core/session/onnxruntime_c_api.cc#L1326).
|
||||
For making changes to the WinRT API someone from the ONNX Runtime team will work with you.
|
||||
If the feature adds new APIs then we'll start an API review. All new public APIs must be reviewed before merging. For making changes to the C API refer to guidance [here](onnxruntime/core/session/onnxruntime_c_api.cc#L1326). For making changes to the Windows Machine Learning WinRT API, please label your request as *api:WinML*, and someone from the Windows ML team will work with you.
|
||||
|
||||
1. **Implementation**
|
||||
5. **Implementation**
|
||||
* A feature can be implemented by you, the ONNX Runtime team, or other community members. Code contributions are greatly appreciated: feel free to work on any reviewed feature you proposed, or choose one in the backlog and send us a PR. If you are new to the project and want to work on an existing issue, we recommend starting with issues that are tagged with “good first issue”. Please let us know in the issue comments if you are actively working on implementing a feature so we can ensure it's assigned to you.
|
||||
* Unit tests: New code *must* be accompanied by unit tests.
|
||||
* Documentation and sample updates: If the PR affects any of the documentation or samples then include those updates in the same PR.
|
||||
|
|
|
|||
32
docs/WinML_principles.md
Normal file
32
docs/WinML_principles.md
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
# Contributing to Windows ML
|
||||
|
||||
Window Machine Learning is a high-performance, reliable API for deploying hardware-accelerated ML inferences on Windows devices. Please visit the [Windows ML documentation](https://docs.microsoft.com/en-us/windows/ai/windows-ml/) to learn more about Windows ML.
|
||||
|
||||
|
||||
## Windows ML Base Principles
|
||||
|
||||
**We design and optimize for all Windows devices.**
|
||||
|
||||
Our goal is to provide developers with a platform that enables new experiences that run well on all Windows devices. Our design drives innovation in the DirectX ecosystem through DirectML and gives developers the confidence that their applications will work for all Windows customers.
|
||||
|
||||
**We maintain and curate the Windows ML APIs.**
|
||||
|
||||
The API is designed to ensure consistency of developer’s experience across the Windows platform. We provide long-term servicing and support, and we are committed to ensuring application’s compatibility as we evolve the API.
|
||||
|
||||
**Windows ML is a core component of Windows.**
|
||||
|
||||
The Windows ML source code is packaged and distributed with each new release of Windows. To provide consumers with high-quality products, Microsoft is responsible for distributing Windows ML and related binaries as part of Windows or standalone distributable packages.
|
||||
|
||||
|
||||
## Open for Community Contributions
|
||||
|
||||
We encourage community contributions to Windows ML to enhance users’ experience on Windows. We use the principles above to guide how we look at and evaluate all contributions.
|
||||
|
||||
Ensure your feature request follows all these principles to help the review process and include information about the customer problem(s) the feature request addresses.
|
||||
|
||||
Note: minor issues or bugs can be addressed more quickly using the [bug/performance issue request](https://github.com/microsoft/onnxruntime/issues/new/choose) rather than feature request.
|
||||
|
||||
## Start your Feature Request
|
||||
|
||||
If you'd like to contribute to Windows ML and engage with the community to get feedback, please review to the contributing [process details](https://github.com/microsoft/onnxruntime/blob/master/CONTRIBUTING.md) and submit a new feature request [here](https://github.com/microsoft/onnxruntime/issues/new/choose).
|
||||
|
||||
Loading…
Reference in a new issue