WebAssembly / WebAssembly/spec
Change direction in wording around stack unwinding
Nobody has claimed this yet.
- Dominant language
- WebAssembly
- Stars
- 3.5k
- Forks
- 539
- Avg merge
- 2d 1h
- Merged PRs (30d)
- 13
Description
The original sentence reads:
Taking a branch unwinds the operand stack up to the height where the targeted structured control instruction was entered.
However, usually one speaks of the top of the stack as where new values are pushed to/popped from. Following that metaphor when talking about unwinding, unwinding goes down in the stack. Hence the following proposal:
Taking a branch unwinds the operand stack
updown to the height where the targeted structured control instruction was entered.
Contributor 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.
Research direction
Open document/core/syntax/instructions.rst at the linked wording around line 691 and review the surrounding discussion of operand-stack unwinding. Change the direction word from “up” to “down” if the proposal matches the specification’s intended metaphor. Done means the sentence uses the agreed wording and the surrounding text remains consistent.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- wasm
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 50/100