Skip to content

Commit

Permalink
Introduce recommendations for external specification modules
Browse files Browse the repository at this point in the history
Bug: #506, #587
  • Loading branch information
Thiago Perrotta committed Nov 17, 2023
1 parent 19777fa commit 0df51d6
Showing 1 changed file with 16 additions and 2 deletions.
18 changes: 16 additions & 2 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -474,8 +474,22 @@ An implementation may define <dfn export>extension modules</dfn>. These must hav
[=module name=] that contains a single colon "<code>:</code>" character. The
part before the colon is the prefix; this is typically the same for all
[=extension modules=] specific to a given implementation and should be unique for a
given implementation. Such modules extend the [=local end definition=] and [=remote end definition=]
providing additional groups as choices for the defined [=commands=] and [=events=].
given implementation.
Such modules extend the [=local end definition=] and [=remote end definition=]
providing additional groups as choices for the defined [=commands=], [=events=] and types.

<dfn export>External specifications</dfn> may define their own modules that
extend the protocol.
The recommendation is that such modules should have a [=module name=] that does
not contain a colon "<code>:</code>" character, and that it is preferred
to add new modules or commands rather than extending existing ones.
Such modules may extend the [=local end definition=] and [=remote end definition=] providing
additional groups as choices for the defined [=commands=], [=events=] and types.

When defining [=extension modules=], implementers should consider the
possibility of future standardization of the module. If the module is
likely to be standardized in the future, implementers should use a
[=module name=] that does not contain a colon "<code>:</code>" character.

## Commands ## {#commands}

Expand Down

0 comments on commit 0df51d6

Please sign in to comment.