Skip to content

Commit 3f008a9

Browse files
committed
Update README.md and other explainers based on 0.3 release
1 parent 11850cc commit 3f008a9

2 files changed

Lines changed: 29 additions & 19 deletions

File tree

README.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,17 @@ reference interpreter and test suite.
1313

1414
## Milestones
1515

16-
The Component Model is currently being incrementally developed and stabilized
17-
as part of [WASI Preview 2]. The subsequent [WASI Preview 3] milestone will be
16+
The Component Model is currently being incrementally developed as part of [WASI]
17+
"Developer Preview" releases. The features enabled by default in a Developer
18+
Preview release are kept stable so that they can be used outside the browser in
19+
production settings to collect feedback that informs subsequent iterations
20+
leading up to the standard 1.0 release.
21+
22+
The current Developer Releases are:
23+
* 0.2: the initial release including ...
24+
* 0.3: adding ...
25+
26+
The subsequent [WASI Preview 3] milestone will be
1827
primarily concerned with the addition of [async and thread support][Concurrency
1928
Model].
2029

@@ -38,5 +47,4 @@ To contribute to any of these repositories, see the Community Group's
3847
[formal spec]: spec/
3948
[W3C WebAssembly Community Group]: https://www.w3.org/community/webassembly/
4049
[Contributing Guidelines]: https://webassembly.org/community/contributing/
41-
[WASI Preview 2]: https://github.com/WebAssembly/WASI/blob/main/docs/Preview2.md
42-
[WASI Preview 3]: https://github.com/WebAssembly/WASI/blob/main/docs/Preview2.md#looking-forward-to-preview-3
50+
[WASI]: https://github.com/webAssembly/wasi

design/mvp/Explainer.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -39,19 +39,27 @@ more user-focused explanation, take a look at the
3939
* [ESM-integration](#ESM-integration)
4040
* [Examples](#examples)
4141

42+
(Based on the previous [scoping and layering] proposal to the WebAssembly CG,
43+
this repo merges and supersedes the [module-linking] and [interface-types]
44+
proposals, pushing some of their original features into the post-MVP [future
45+
feature](FutureFeatures.md) backlog.)
46+
47+
4248
## Gated Features
4349

4450
By default, the features described in this explainer (as well as the supporting
4551
[Binary.md](Binary.md), [WIT.md](WIT.md) and [CanonicalABI.md](CanonicalABI.md))
46-
have been implemented and are included in the [WASI Preview 2] stability
47-
milestone. Features that are not part of Preview 2 are demarcated by one of the
48-
emoji symbols listed below; these emojis will be removed once they are
49-
implemented, considered stable and included in a future milestone:
52+
have been implemented and are included in the [WASI] 0.2 Developer Preview
53+
release. The WASI 0.3 Developer Preview release additionally includes the
54+
features gated by 🔀.
55+
56+
The other features, in various stages of implementation, polish and release, are
57+
gated by the following emojis and, when ready, may be included in subsequent
58+
WASI Developer Preview (minor) release:
5059
* 🪙: value imports/exports and component-level start function
5160
* 🪺: nested namespaces and packages in import/export names
52-
* 🔀: async
53-
* 🚝: enabling more canonical ABI options on more async-related builtins
54-
* 🚟: using `async` with `canon lift` without `callback` (stackful lift)
61+
* 🚝: enabling more canonical ABI options on more async-related builtins
62+
* 🚟: using `async` with `canon lift` without `callback` (stackful lift)
5563
* 🧵: threading built-ins
5664
* 🧵②: [shared-everything-threads]-based threading built-ins
5765
* 🔧: fixed-length lists
@@ -61,11 +69,6 @@ implemented, considered stable and included in a future milestone:
6169
* 🗺️: the `map` type
6270
* 🏷️: `implements` annotations for plain-named interface imports/exports
6371

64-
(Based on the previous [scoping and layering] proposal to the WebAssembly CG,
65-
this repo merges and supersedes the [module-linking] and [interface-types]
66-
proposals, pushing some of their original features into the post-MVP [future
67-
feature](FutureFeatures.md) backlog.)
68-
6972

7073
## Grammar
7174

@@ -2945,7 +2948,7 @@ have a `canonversion`, and the concatenation of the `canonversion` and
29452948
For compatibility with older versions of this spec, non-canonical
29462949
`interfacename`s (with `interfaceversion`s matching any `valid semver`) are
29472950
temporarily permitted. These non-canonical names may trigger warnings and will
2948-
start being rejected some time after after [WASI Preview 3] is released.
2951+
start being rejected at some point in the future.
29492952

29502953

29512954
## Component Invariants
@@ -3319,8 +3322,7 @@ For some use-case-focused, worked examples, see:
33193322
[memory64]: https://github.com/webAssembly/memory64
33203323
[`rectype`]: https://webassembly.github.io/gc/core/text/types.html#text-rectype
33213324
[shared-everything-threads]: https://github.com/WebAssembly/shared-everything-threads
3322-
[WASI Preview 2]: https://github.com/WebAssembly/WASI/tree/main/wasip2#readme
3323-
[WASI Preview 3]: https://github.com/WebAssembly/WASI/tree/main/wasip2#looking-forward-to-preview-3
3325+
[WASI]: https://github.com/webAssembly/wasi
33243326
[reference types]: https://github.com/WebAssembly/reference-types/blob/master/proposals/reference-types/Overview.md
33253327
[GC ABI Option]: https://github.com/WebAssembly/component-model/issues/525
33263328

0 commit comments

Comments
 (0)