WebAssembly / WebAssembly/spec

Some links in the archived version of the W3C/bikeshed version of the Wasm spec are broken

Open
#2,051 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
WebAssembly
Stars
3.5k
Forks
539
Avg merge
2d 1h
Merged PRs (30d)
13

Description

I need permalinks to a given version of the spec, which I can reference in implementation source code and requirements of our interpreter.

Luckily, W3C got us covered:

https://www.w3.org/standards/history/wasm-core-2/ has the history of all releases of the Wasm 2.0 core specification.

It provides a permalink to the currently most up to date version of the CRD:

https://www.w3.org/TR/2025/CRD-wasm-core-2-20250616/

Within that document, however, some links are broken. I.e. here: when clicking the memory intance link beneath mem_read, it redirects us to

https://www.w3.org/TR/2025/CRD-wasm-core-2-20250616/index.html#syntax-meminst

which does not exist (i.e. we get a "Document not found" landing page). The culprit in that link is the index.html. Removing that makes the link work.

Notably, not all links are broken, i.e. the memory instance link in beneath here is fine.

Thanks to my colleague @cemonem for pointing out this bug.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the broken link from the archived W3C Wasm 2.0 CRD at #memories①①, comparing it with the working link at #external-values①. Trace those generated links back to the Bikeshed specification sources or build entry point, then verify that the affected memory-instance links resolve without the extra index.html while unaffected links remain valid.

Written by the indexing model from the issue text.

Assessment

Tech stack
wasm
Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.