|
| 1 | +# Contributing to Web Machine Learning website |
| 2 | + |
| 3 | +First of all, thank you very much for your interest in contributing to Web Machine Learning website! We're really happy to accept contributions from everyone, whether you're a browser engineer, a spec writer or a web developer. |
| 4 | + |
| 5 | +## WebNN Implementation Status |
| 6 | + |
| 7 | +This repository contains raw data from the [WebNN Implementation Status](https://webmachinelearning.github.io/webnn-status/) tables. If you are interested in updating or adding to the WebNN Implementation Status data on the site, please edit the [webnn_status.json](./assets/json/webnn_status.json) file. |
| 8 | + |
| 9 | +The WebNN API [browser compat data (BCD)](https://github.com/search?q=repo%3Amdn%2Fbrowser-compat-data+webnn&type=code) is the upstream and we will keep it up to date as a first priority. The [webnn_status.json](./assets/json/webnn_status.json) adds the following domain-specific data on top of the [WebNN API BCD](https://github.com/search?q=repo%3Amdn%2Fbrowser-compat-data+webnn&type=code) baseline data: |
| 10 | + |
| 11 | +- WebNN ops mapping to native backends |
| 12 | +- WebNN WPT test and test result links |
| 13 | +- WebNN JavaScript ML Frameworks integration status |
| 14 | + |
| 15 | +### WebNN Implementation Status Data |
| 16 | + |
| 17 | +The [webnn_status.json](./assets/json/webnn_status.json) is the data source for the [WebNN Implementation Status](https://webmachinelearning.github.io/webnn-status/) page. By contributing updates to this file on GitHub you can help keep the implementation status page up to date. An example entry for the [`argMax`](https://www.w3.org/TR/webnn/#dom-mlgraphbuilder-argmax) op looks like the following: |
| 18 | + |
| 19 | +``` |
| 20 | + { |
| 21 | + "op": "argMax", |
| 22 | + "op_id": "argminmax", |
| 23 | + "version": "", |
| 24 | + "wpt": "arg_min_max", |
| 25 | + "wpt_progress": 4, |
| 26 | + "xnnpack_op": [ |
| 27 | + "" |
| 28 | + ], |
| 29 | + "xnnpack_progress": 2, |
| 30 | + "xnnpack_chromium_version_added": "", |
| 31 | + "dml_op": [ |
| 32 | + "REDUCE_FUNCTION_ARGMAX" |
| 33 | + ], |
| 34 | + "dml_progress": 4, |
| 35 | + "dml_chromium_version_added": "M122", |
| 36 | + "mlservice_op": [ |
| 37 | + "" |
| 38 | + ], |
| 39 | + "mlservice_progress": 2, |
| 40 | + "mlservice_chromium_version_added": "", |
| 41 | + "tflite_op": [ |
| 42 | + "" |
| 43 | + ], |
| 44 | + "tflite_progress": 2, |
| 45 | + "tflite_version_added": "", |
| 46 | + "ort_op": [ |
| 47 | + "ArgMax" |
| 48 | + ], |
| 49 | + "ort_progress": 4, |
| 50 | + "ort_version_added": "main", |
| 51 | + "notes": "" |
| 52 | + } |
| 53 | +``` |
| 54 | + |
| 55 | +### Supported Changes |
| 56 | + |
| 57 | +Currently the following feature information can be modified for WebNN XNNPACK, DirectML and MLService backends: |
| 58 | + |
| 59 | +* **op** - Operation name defined in [Web Neural Network API](https://www.w3.org/TR/webnn/) spec |
| 60 | +* **op_id** - Operation name defined in anchor link in the spec |
| 61 | +* **wpt** - The WebNN test cases id used in [Web Platform Tests](https://github.com/web-platform-tests/wpt/tree/master/webnn) and [WPT dashboard](https://wpt.fyi/) |
| 62 | +* **[*]_op** - The operation list of native ML libraries or the JavaScript ML frameworks that map to WebNN API |
| 63 | +* **[*]_version_added** - The Chromium or the JavaScript ML framework version where support for the feature was added |
| 64 | +* **[*]_progress** |
| 65 | + * **1** - Not Implemented / Not Supported |
| 66 | + * **2** - Work in Progress |
| 67 | + * **3** - Partial Implementation |
| 68 | + * **4** - Implemented / Supported |
| 69 | + |
| 70 | +## License |
| 71 | + |
| 72 | +The data in this repository is available for use under the [W3C Software and Document license](https://www.w3.org/Consortium/Legal/copyright-software). |
0 commit comments