diff --git a/Charter.md b/Charter.md new file mode 100644 index 0000000..2de45cf --- /dev/null +++ b/Charter.md @@ -0,0 +1,59 @@ +# WebAssembly Debugging Subgroup Charter + +The Debugging Subgroup is a sub-organization of the +[WebAssembly Community Group](https://www.w3.org/community/webassembly/) of the W3C. +As such, it is intended that its charter align with that of the CG. In particular, +the sections of the [CG charter](https://webassembly.github.io/cg-charter/) relating to +[Community and Business Group Process](https://webassembly.github.io/cg-charter/#process), +[Contribution Mechanics](https://webassembly.github.io/cg-charter/#contrib), +[Transparency](https://webassembly.github.io/cg-charter/#transparency), and +[Decision Process](https://webassembly.github.io/cg-charter/#decision) also apply to the Subgroup. + +## Goals + +The mission of this sugbroup is to provide a forum for pre-standardization +collaboration on debugging capabilities for WebAssembly programs. + +## Scope + +The Subgroup will consider topics related to debugging, profiling, or +static analysis of WebAssembly programs, including: + +- File formats and encodings for WebAssembly debug information +e.g. as custom sections in wasm executables or object files, +- Extensions to the WebAssembly text format for debug information +- Interaction with browsers or other embedders (e.g. developer tools, debugging, profiling) +- Interaction with external debuggers and IDEs (VS Code), and +debuggers running as wasm-hosted code. +- Presentation of source, callstack, or debugging information in embedders, debuggers, +or IDEs + + +## Deliverables + +### Specifications +The Subgroup may produce several kinds of specification-related work output: +- Extensions or amendments to existing specifications (e.g. Wasm core or +web spec, DWARF, EcmaScript) +- Creation of new specifications in standards bodies or working +groups (e.g. Wasm WG, TC39, or future general web-debugging standards working group) +- Creation of new specifications outside of standards bodies +(e.g. similar to the LLVM object file format documentation in Wasm tool conventions) + +### Non-normative reports +The Subgroup may produce non-normative material such as requirements +documents, recommendations, and use cases. + +### Software +The Subgroup may produce software related to Wasm debugging (either as +standalone tooling or integration of debugging related functionality +in existing CG software such as Binaryen or WABT). Capabilities may include: +- Debug info encoding or translation +- Program instrumentation or analysis +- Interactive debuggers or profilers +- Test suites + +## Amendments to this Charter and Chair Selection + +This charter may be amended, and Subgroup Chairs may be selected by vote of the full +WebAssembly Community Group. diff --git a/Readme.md b/Readme.md new file mode 100644 index 0000000..0d0ee8d --- /dev/null +++ b/Readme.md @@ -0,0 +1,7 @@ +# WebAssembly Debugging Subgroup + +This repository is for the Debugging Subgroup of the +[WebAssembly Community Group](https://www.w3.org/community/webassembly/). Its +[Charter](Charter.md) describes the goals, scope and deliverables of the group. +The repository may contain meeting notes, reports, documentation, specifications and/or software +produced by the group (although larger projects may also have their own repositories).