Skip to content

Latest commit

 

History

History
86 lines (62 loc) · 6.63 KB

Proposals.md

File metadata and controls

86 lines (62 loc) · 6.63 KB

WASI proposals

WASI APIs are developed as proposals. These proposals go through 5 phases of development (following the WebAssembly CG's Phase Process).

You can learn more about contributing new proposals (and other ways to contribute) in our Contributing guide.

Active Proposals

Phase 5 - The Feature is Standardized (WG)

Proposal Champion Versions

Phase 4 - Standardize the Feature (WG)

Proposal Champion Versions

Phase 3 - Implementation Phase (CG + WG)

Proposal Champion Versions

Phase 2 - Proposed Spec Text Available (CG + WG)

Proposal Champion Versions
I/O Dan Gohman
Filesystem Dan Gohman
"Classic" Command-Line (Legacy, to be deprecated in Q4 2022) Dan Gohman
Clocks Dan Gohman
Random Dan Gohman
Handle Index Dan Gohman
Poll Dan Gohman
Machine Learning (wasi-nn) Andrew Brown and Mingqiu Sun

Phase 1 - Feature Proposal (CG)

Proposal Champion Versions
Crypto Frank Denis and Daiki Ueno
HTTP Piotr Sikora
Parallel Andrew Brown
Sockets Dave Bakker

Phase 0 - Pre-Proposal (CG)

Note: The pre-proposal phase is simply meant as a way to share ideas. This means that there may be overlap between pre-proposals. It also means that the WASI subgroup has not yet decided that the pre-proposal is in scope for WASI.

Proposal Champion Versions
singlestore-labs/wasi-data Bailey Hayes
proxy-wasm/spec (will advance as multiple, smaller proposals) Piotr Sikora

Versioning

Once a proposal reaches Phase 3, we expect the champions to start creating releases, following the conventions of semantic versioning (semver). Releases for active proposals are linked in the chart above.

Proposals remain in the 0.x semver range until they reach Phase 5 and are fully standardized. At that point, a 1.0 release should be made available.

For some APIs, it makes sense to add new features after the API itself has reached Phase 5. These feature additions should go through the same standardization process. Once they have reached Phase 5, the minor version number of the release should be incremented.

Some APIs may require backwards-incompatible changes over time. In these cases, we allow proposals to increment the major version number only if the old API can be implmented in terms of the new API. As part of the new version, champions are expected to provide a tool that enables this backwards-compatibility. If that is not possible, then a new API proposal with a new name should be started. The original API can then be deprecated over time if it makes sense to do so.