WebAssembly / WebAssembly/custom-descriptors

Core spec authoring checklist

Open
#94 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
WebAssembly
Stars
12
Forks
3
Avg merge
3d 2h
Merged PRs (30d)
1

Description

  • Syntax
    • Exact heap types (#93)
    • Descriptor types (#99)
    • Exact function externtypes (#102)
    • Instructions
      • struct.new_desc and struct.new_default_desc (#101)
      • ref.get_desc (#104)
      • ref.cast_desc_eq, br_on_cast_desc_eq, and br_on_cast_desc_eq_fail (#105)
  • Validation
    • Exact heap types ok and subtyping (#97)
    • Descriptor types ok and subtyping
    • Exact function externtypes ok and subtyping (#102)
    • Instructions
      • Relaxed br_on_cast and br_on_cast_fail(#92)
      • Restrict struct.new and struct.new_default to types without descriptors (#101)
      • Make allocation instruction results exact (#103)
      • struct.new_desc and struct.new_default_desc, including as constant expressions (#101)
      • ref.get_desc (#104)
      • ref.cast_desc_eq, br_on_cast_desc_eq, and br_on_cast_desc_eq_fail (#105)
  • Execution
    • Descriptors in struct instances
    • Function instances valid with exact externtypes
    • Instructions
      • struct.new_desc and struct.new_default_desc
      • ref.get_desc
      • ref.cast_desc_eq, br_on_cast_desc_eq, and br_on_cast_desc_eq_fail
  • Binary format (#108)
    • Exact heap types
    • Descriptor types
    • Exact function externtypes (#102)
    • Instructions
      • struct.new_desc and struct.new_default_desc
      • ref.get_desc
      • ref.cast_desc_eq, br_on_cast_desc_eq, and br_on_cast_desc_eq_fail
  • Text format
    • Exact heap types
    • Descriptor types
    • Exact function externtypes (#102)
    • Instructions
      • struct.new_desc and struct.new_default_desc
      • ref.get_desc
      • ref.cast_desc_eq, br_on_cast_desc_eq, and br_on_cast_desc_eq_fail
  • Appendix
    • Exactness type variables for principal types
    • Validation algorithm
    • Change history
  • Indices
    • Types
    • Instructions
    • Semantic rules
    • Index ("exact", "desctype", "descriptor")

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

Review the checklist in issue #94 together with the referenced work items (#92, #93, #97, #99, #101, #102, #103, #104, #105, and #108). Done means completing the remaining syntax, validation, execution, binary format, text format, appendix, and index entries for the custom descriptors core specification.

Written by the indexing model from the issue text.

Assessment

Tech stack
wasm
Domain
compilers, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.