Skip to content

Commit 748cd76

Browse files
Take Martin's comments.
Co-authored-by: Martin Thomson <mt@lowentropy.net>
1 parent e5dc1d8 commit 748cd76

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

index.bs

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3723,9 +3723,9 @@ This implies that most optional features should be defined
37233723
in the same specification that defined the original feature.
37243724

37253725
Sometimes new extensions are expected to be needed in the future.
3726-
In this case, the right plan is often to
3727-
have the original standards body continue or restart
3728-
a working group to produce an update to the feature's full specification.
3726+
It is often most appropriate
3727+
to have revise the specification to define an extension.
3728+
This can reduce or avoid any need to precisely define requirements for extensions.
37293729

37303730
However, if extensions need to be defined through
37313731
a different process than updating the full specification,
@@ -3736,7 +3736,7 @@ but another similar mechanism is also acceptable.
37363736

37373737
Registries are helpful because they
37383738

3739-
1. Reduce name collisions.
3739+
* reduce name collisions,
37403740
1. Help readers find the name for a desired purpose.
37413741
1. Direct readers to a specification for each name
37423742
(if the registry requires this).
@@ -3752,7 +3752,7 @@ before that interface has several implementations,
37523752
so any new registry should start with at least 2-3 entries defined.
37533753

37543754
It is tempting to additionally require that registry entries be
3755-
"good" in some way beyond simply being specified.
3755+
"good" in some way beyond what is needed to achieve interoperability.
37563756
Use a permissive registration policy instead of doing this
37573757
unless the feature includes
37583758
some way to enforce that no implementation can use an unregistered name.
@@ -3779,7 +3779,7 @@ or even that the domain stays under the control of the entity that defined the e
37793779
URLs are appropriate for a few kinds of completely-permissionless extension,
37803780
but most of the time a WG-managed permissive registry table will work better.
37813781

3782-
See [[qaframe-spec#extensions]] for
3782+
See [[qaframe-spec#extensions]] and [[RFC6709]] for
37833783
more guidance on how to design extensibility.
37843784

37853785
<h3 id="implementability">Resolving tension between interoperability and implementability</h3>

0 commit comments

Comments
 (0)