Skip to content

Commit 94d531a

Browse files
authored
Expand on the documentation describing Preview 3. (#581)
Add some more documentation about what WASI Preview 3 is expected to be about: replacing wasi-io with future, stream, integrated async, and also incorporating lessons learned. And also mention how implementations may continue to support Preview 2 even after Preview 3 is launched.
1 parent 043eafa commit 94d531a

File tree

1 file changed

+13
-3
lines changed

1 file changed

+13
-3
lines changed

preview2/README.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -69,9 +69,19 @@ and their existing Witx machinery.
6969

7070
## Looking forward to Preview 3
7171

72-
Preview 3 will add the new `stream` and `future` keywords. The
73-
release criteria of Preview 3 will include that performance will be
74-
measured and addressed.
72+
The component model is expected to add `future` and `stream` keywords, which
73+
will provide integrated and composable `async` functionality. WASI Preview 3 is
74+
planned to be a major revision of the Preview 2 APIs using these new features
75+
in place of wasi-io's streams and polling interfaces. It's also expected to
76+
incorporate lessons learned from implementation and user experience with
77+
Preview 2.
78+
79+
When Preview 3 is launched, implementations may continue to support Preview 2,
80+
either by implementing Preview 3 along side it, or by virtualizing (polyfilling)
81+
Preview 2 in terms of Preview 3.
82+
83+
The release criteria of Preview 3 will include that performance will be measured
84+
and addressed.
7585

7686
[WASI Subgroup Phase Process]: https://github.com/WebAssembly/WASI/blob/main/Contributing.md#the-phase-process
7787
[portability criteria]: https://github.com/WebAssembly/WASI/blob/main/Contributing.md#2-feature-description-available-wasi-subgroup

0 commit comments

Comments
 (0)