Add introduction sections to JS API and Web API documents #1814
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
rossberg
approved these changes
Sep 28, 2024
document/js-api/index.bs
Outdated
| with their surrounding execution environment. Instead it defines an abstract [=embedding interface=] between WebAssembly and its environment, | ||
| (called the *embedder*). It is only through this interface that an embedder interacts with the semantics of WebAssembly, and the embedder | ||
| implements the connection between its host environment and the embedding API. | ||
| This document describes the embedding of WebAssembly into JavaScript [[ECMASCRIPT]] environments, including how WebAssembly modules |
There was a problem hiding this comment.
I noted that ECMASCRIPT isn't actually listed in the biblio section above. Is that somehow automatic?
There was a problem hiding this comment.
yes: https://github.com/speced/bikeshed-data/blob/main/data/biblio/biblio-ec.data#L31 (there's probably an easier place to look than these raw files but I'm not sure where it is :)
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
These sections provide a bit more background about their relationship to the layer beneath them.
They also solve the problem that the existing minimal introductory text was hidden in the
bottom of the "status of this document" section.