Skip to content

Commit de6ec3e

Browse files
authored
Linkify stability policy
Fixes #930 Also clarifies that [!IMPORANT] blocks are normative.
1 parent f3344b5 commit de6ec3e

File tree

1 file changed

+27
-23
lines changed

1 file changed

+27
-23
lines changed

spec/README.md

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -72,8 +72,12 @@ A **_term_** looks like this when it is defined in this specification.
7272

7373
A reference to a _term_ looks like this.
7474

75+
> [!NOTE]
7576
> Examples are non-normative and styled like this.
7677
78+
> [!IMPORTANT]
79+
> Text marked "Important" like this are normative.
80+
7781
### Stability Policy
7882

7983
> [!IMPORTANT]
@@ -84,42 +88,42 @@ Updates to this specification will not make any valid _message_ invalid.
8488

8589
Updates to this specification will not remove any syntax provided in this version.
8690

87-
Updates to this specification will not specify an error for any message
88-
that previously did not specify an error.
91+
Updates to this specification will not specify an _error_ for any _message_
92+
that previously did not specify an _error_.
8993

90-
Updates to this specification will not specify the use of a fallback value for any message
91-
that previously did not specify a fallback value.
94+
Updates to this specification will not specify the use of a _fallback value_ for any _message_
95+
that previously did not specify a _fallback value_.
9296

9397
Updates to this specification will not change the syntactical meaning
9498
of any syntax defined in this specification.
9599

96-
Updates to this specification will not remove any functions defined in the default registry.
100+
Updates to this specification will not remove any _functions_ defined in the default function registry.
97101

98-
Updates to this specification will not remove any options or option values
99-
defined in the default registry.
102+
Updates to this specification will not remove any _options_ or _option_ values
103+
defined in the default function registry.
100104

101105
> [!NOTE]
102106
> The foregoing policies are _not_ a guarantee that the results of formatting will never change.
103107
> Even when this specification or its implementation do not change,
104-
> the functions for date formatting, number formatting and so on
108+
> the _function handlers_ for date formatting, number formatting and so on
105109
> can change their results over time or behave differently due to local runtime
106110
> differences in implementation or changes to locale data
107111
> (such as due to the release of new CLDR versions).
108112
109113
Updates to this specification will only reserve, define, or require
110-
function identifiers and function option identifiers
114+
_function_ _identifiers_ and _function_ _option_ _identifiers_
111115
which satisfy either of the following two requirements:
112-
- Includes no namespace,
113-
and has a name consisting of characters in the ranges a-z, A-Z, and 0-9,
116+
- Includes no _namespace_,
117+
and has a _name_ consisting of characters in the ranges a-z, A-Z, and 0-9,
114118
and the characters U+002E FULL STOP `.`, U+002D HYPHEN-MINUS `-`, and U+005F LOW LINE `_`.
115-
- Uses a namespace consisting of a single character in the ranges a-z and A-Z.
119+
- Uses a _namespace_ consisting of a single character in the ranges a-z and A-Z.
116120

117-
All other identifiers in these categories are reserved for the use of implementations or users.
121+
All other _identifiers_ in these categories are reserved for the use of implementations or users.
118122

119123
> [!NOTE]
120-
> Users defining custom identifiers SHOULD include at least one character outside these ranges
124+
> Users defining custom _identifiers_ SHOULD include at least one character outside these ranges
121125
> to ensure that they will be compatible with future versions of this specification.
122-
> They SHOULD also use the namespace feature to avoid collisions with other implementations.
126+
> They SHOULD also use the _namespace_ feature to avoid collisions with other implementations.
123127
124128
Future versions of this specification will not introduce changes
125129
to the data model that would result in a data model representation
@@ -133,17 +137,17 @@ based on this version being invalid.
133137
> - Future versions may define new syntax and structures
134138
> that would not be supported by this version of the specification.
135139
> - Future versions may add additional structure or meaning to existing syntax.
136-
> - Future versions may define new keywords.
137-
> - Future versions may make previously invalid messages valid.
138-
> - Future versions may define additional functions in the default registry
139-
> or may reserve the names of functions for the purposes of interoperability.
140-
> - Future versions may define additional options to existing functions.
141-
> - Future versions may define additional option values for existing options.
142-
> - Future versions may deprecate (but not remove) keywords, functions, options, or option values.
140+
> - Future versions may define new _keywords_.
141+
> - Future versions may make previously invalid _messages_ valid.
142+
> - Future versions may define additional _functions_ in the default registry
143+
> or may reserve the names of _functions_ for the purposes of interoperability.
144+
> - Future versions may define additional _options_ to existing functions.
145+
> - Future versions may define additional _option_ values for existing _options_.
146+
> - Future versions may deprecate (but not remove) _keywords_, _functions_, _options_, or _option_ values.
143147
> - Future versions of this specification may introduce changes
144148
> to the data model that would result in future data model representations
145149
> not being valid for implementations of this version of the data model.
146-
> - For example, a future version could introduce a new keyword,
150+
> - For example, a future version could introduce a new _keyword_,
147151
> whose data model representation would be a new interface
148152
> that is not recognized by this version's data model.
149153

0 commit comments

Comments
 (0)