From ae60805e80eb1a22f30dd6bd5cabd277ff17a1d7 Mon Sep 17 00:00:00 2001 From: Derek Schuff Date: Mon, 2 Jul 2018 11:14:07 -0700 Subject: [PATCH 1/2] Proposed charter for debugging subgroup --- subgroups/Debugging.md | 57 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 subgroups/Debugging.md diff --git a/subgroups/Debugging.md b/subgroups/Debugging.md new file mode 100644 index 00000000..f6af6dd3 --- /dev/null +++ b/subgroups/Debugging.md @@ -0,0 +1,57 @@ +# 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 relating to Community and Business Group Process, +Contribution Mechanics, Transparency, and Decision Process 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 +- Extensions or modifications to +- Interaction with browsers (e.g. developer tools, debugging, profiling) +- Interaction with external debuggers and IDEs (VS Code), and +debuggers running in the browser +- Presentation of source, callstack, or debugging information in browsers, 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. From 4874b47dbb0a4f54b1f5d9d2d3671d7836d6505a Mon Sep 17 00:00:00 2001 From: Derek Schuff Date: Mon, 2 Jul 2018 16:25:09 -0700 Subject: [PATCH 2/2] Add CG charter links, use 'embedders', remove stray bullet --- subgroups/Debugging.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/subgroups/Debugging.md b/subgroups/Debugging.md index f6af6dd3..2de45cf6 100644 --- a/subgroups/Debugging.md +++ b/subgroups/Debugging.md @@ -3,8 +3,11 @@ 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 relating to Community and Business Group Process, -Contribution Mechanics, Transparency, and Decision Process also apply to the Subgroup. +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 @@ -19,11 +22,10 @@ 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 -- Extensions or modifications to -- Interaction with browsers (e.g. developer tools, debugging, profiling) +- Interaction with browsers or other embedders (e.g. developer tools, debugging, profiling) - Interaction with external debuggers and IDEs (VS Code), and -debuggers running in the browser -- Presentation of source, callstack, or debugging information in browsers, debuggers, +debuggers running as wasm-hosted code. +- Presentation of source, callstack, or debugging information in embedders, debuggers, or IDEs