Skip to content

Commit c96c349

Browse files
committed
tweaks to problem statement
1 parent cd49ab9 commit c96c349

File tree

1 file changed

+14
-7
lines changed

1 file changed

+14
-7
lines changed

proposals/vocabularies.md

+14-7
Original file line numberDiff line numberDiff line change
@@ -45,13 +45,20 @@ also apply to this document.
4545

4646
### Problem Statement
4747

48-
The specification allows implementations to support user-defined keywords. However, this vague and open allowance has drawbacks.
49-
50-
1. This isn't a requirement, it is a permission. An implementation could just as easily choose _not_ to support user-defined keywords.
51-
2. There is no prescribed mechanism by which an implementation should provide this support. As a result, each implementation that _does_ have the feature supports it in different ways.
52-
3. Support for any given user-defined keyword will be limited to that implementation. There is no guarantee that the keyword will be supported in another implementation, and unless the user explicitly configures the other implementation, their keywords likely will not be supported.
53-
54-
This exposes a need for the specification(s) to define a way for implementations to share knowledge of a keyword or group of keywords.
48+
The specification allows implementations to support user-defined keywords.
49+
However, this vague and open allowance has drawbacks.
50+
51+
1. This isn't a requirement, it is a permission. An implementation could just as
52+
easily (_more_ easily) choose _not_ to support user-defined keywords.
53+
2. There is no prescribed mechanism by which an implementation should provide
54+
this support. As a result, each implementation that _does_ have the feature
55+
supports it in different ways.
56+
3. Support for any given user-defined keyword will be limited to that
57+
implementation. Unless the user explicitly configures another
58+
implementation, their keywords likely will not be supported.
59+
60+
This exposes a need for the specification(s) to define a way for implementations
61+
to share knowledge of a keyword or group of keywords.
5562

5663
### Solution
5764

0 commit comments

Comments
 (0)