-
Notifications
You must be signed in to change notification settings - Fork 696
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update API portability paragraph #152
Conversation
1ca4ed6
to
b584d71
Compare
WebAssembly does not specify any APIs or syscalls, only an | ||
[import mechanism](MVP.md#modules) where the set of available imports is defined | ||
by the host environment. In a [Web](Web.md) environment, functionality is | ||
accessed through the Web APIs defined by the [Web](https://whatwg.org) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Confusing to have two "Web" links lead to different places.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done, changed link to wikipedia "Open Web Platform" instead which gives a more comprehensive list anyhow.
IIUC one of @sunfishcode's objections was that this paragraph speaks to a different audience. Developers and implementors understand "portability" differently. To address this, maybe this paragraph could have its own sub-header? And the rest of Portability.md above also have a sub-header? |
3f8bdc7
to
ed9d5f6
Compare
That's a good suggestion @jfbastien. @sunfishcode any better? |
@@ -4,6 +4,8 @@ WebAssembly's [binary format](BinaryEncoding.md) is designed to be executable | |||
efficiently on a variety of operating systems and instruction set architectures, | |||
[on the Web](Web.md) and [off the Web](NonWeb.md). | |||
|
|||
## Execution |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How about "What platforms can WebAssembly run on?"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How about "Assumptions for efficient execution"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Works for me.
Yes, this is better. I think we can do more, but this is good for now. |
lgtm |
1 similar comment
lgtm |
Thanks, all. |
Update API portability paragraph
Capturing discussion from #146, though discussion can continue here. I made some further tweaks to clarify.