Missing ability to access built older versions of the WebAssembly specification in archivable form
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 35/100
- Issue type
- Documentation
- Clarity
- Needs clarification
- Activity status
- Stale
- Tech stack
- wasm
- Domain
- documentation
Research direction
No repository files or tests are named. Start by reviewing how the current WebAssembly specification builds and publishes its downloadable artifacts, then compare the W3C core 1.0 page with the proposal mirror linked in the issue. Done means an authoritative, archivable set of built WebAssembly 1.0 artifacts is available.
Written by the indexing model from the issue text.
Description
There does not appear to be a simple way to access built older versions of the WebAssembly specification, particularly 1.0, in archivable form (the various builds, i.e. PDF etc.)
I was at least able to find the W3C version of the core specification ( https://www.w3.org/TR/wasm-core-1/# ), but that appears to be all, and it doesn't appear to have any standardized archival download readily available.
Why care about 1.0?
There are two main use-cases I can think of for the WebAssembly 1.0 specification:
- With the addition of extensions/etc. onto the "MVP" version of WebAssembly in the core specification (for example:
v128), the support for these in browsers that are actually available on end-user devices will vary. There will be, for quite some time, the need to maintain WebAssembly 1.0-compliant versions of ecosystem software. - Non-browser targets (i.e. WASI) may use custom WebAssembly runtimes that may not have use for functionality such as vectorization. Alternatively, non-browser usecases may require targetting outdated runtimes. These usecases benefit from being able to point at a specific specification version as the standard.
- A practical example would be https://github.com/dtolnay/watt, which contains a WebAssembly interpreter. This interpreter seems to be intended solely for the purpose of running compiled Rust code handling abstract token streams. This is reliant on upstream tooling supporting an unextended WebAssembly 1.0 environment -- it would break if tooling support for WebAssembly 1.0 were to begin failing (i.e. by including WebAssembly 2.0 features in code intended to target WebAssembly 1.0).
It is thus important to keep available the specification versions that actually apply to these targets.
Workaround
A present workaround is to use the mirrors generated by WebAssembly project proposals that were forked from late-stage 1.0, i.e. https://webassembly.github.io/multi-value/core/_download/WebAssembly.pdf -- however, there are still some differences, so this is probably not a definitive 1.0.
- Dominant language
- WebAssembly
- Stars
- 3.5k
- Forks
- 539
- Avg merge
- 10h 38m
- Merged PRs (30d)
- 12
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from WebAssembly/spec
-
Difficulty 5/5 Over a week Newbie friendliness 35/100
WebAssembly/spec#2258 · 4 comments · 1 reaction ·
Maintainers usually reply within 1 day
-
Difficulty 3/5 1-2 days Newbie friendliness 58/100
WebAssembly/spec#2253 ·
Maintainers usually reply within 1 day
-
[spectec] Wasm 1.0: `$instantiate` missing premisesPossibly taken @rossberg claimed this 25 days ago. Open
Difficulty 3/5 1-2 days Newbie friendliness 68/100
WebAssembly/spec#2245 ·
Maintainers usually reply within 1 day
-
Difficulty 4/5 3-5 days Newbie friendliness 45/100
WebAssembly/spec#2235 · 9 comments ·
Maintainers usually reply within 1 day
-
Difficulty 4/5 3-5 days Newbie friendliness 35/100
WebAssembly/spec#2196 ·
Maintainers usually reply within 1 day
All issues in WebAssembly/spec
Similar issues
-
sync-en
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 3 days
-
docs needs_triage
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
ansible/ansible#87630 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
mattpocock/skills#1165 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Maintainers usually reply within 1 day
-
Impact: Low Severity: Minor
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
vaadin/flow#26179 · 2 comments ·
Maintainers usually reply within 1 day