Document per-item versions using `@since` gates

WebAssembly / wasi-cli

Command-Line Interface (CLI) World for WASI

60 stars 11 forks source link

Document per-item versions using `@since` gates #43

Closed yoshuawuyts closed 1 month ago

yoshuawuyts commented 3 months ago

Depends on https://github.com/WebAssembly/component-model/pull/332 to be merged first. This documents the stability of all items using the @since gate notation, enabling WIT documents to be updated over time without major compatibility hazards.

For an overview of how this would apply to all existing WASI APIs, including the unstable timezone API, see https://github.com/WebAssembly/WASI/pull/604. Thanks!

yoshuawuyts commented 1 month ago

This PR has the same error as https://github.com/WebAssembly/wasi-http/pull/114#issuecomment-2197661559, likely for a similar reason.