Skip to content

Commit 1d35646

Browse files
authored
Add WebNN implementation status contribution mechanics (#67)
* Add WebNN implementation status contribution mechanics
1 parent fbc6232 commit 1d35646

2 files changed

Lines changed: 84 additions & 1 deletion

File tree

CONTRIBUTING.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
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).

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
# Web Machine Learning
1+
<p align="center"><img width="30%" src="./logos/webml/logo-webml-white.png" /></p>
2+
3+
W3C Web Machine Learning Working Group and Community Group website.
24

35
## Environment Setup
46

@@ -7,8 +9,17 @@ gem install bundler jekyll
79
```
810

911
## Run
12+
1013
```
1114
bundle install
1215
bundle exec jekyll serve
1316
Server address: http://127.0.0.1:4000/
1417
```
18+
19+
## Contributing
20+
21+
We welcome contributions! Please see the [contributing guidelines](CONTRIBUTING.md).
22+
23+
## License
24+
25+
All documents in this repository are licensed by contributors under the [W3C Software and Document license](https://www.w3.org/Consortium/Legal/copyright-software).

0 commit comments

Comments
 (0)