Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Proposed charter for debugging subgroup #271

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 57 additions & 0 deletions subgroups/Debugging.md
Original file line number Diff line number Diff line change
@@ -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,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps link to these sections here?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea, done.

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

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should the following bullet points be indented?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually I think the intent was just to remove this bullet (as the following bullets are still "topics")

- 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.