Skip to content

Commit 698d508

Browse files
aphillipseemeli
andauthored
Address #683: make registry data model non-TP (#684)
* Address #683: make registry data model non-TP This clarifies the status of the registry data model as experimental. * Apply suggestions from code review Co-authored-by: Eemeli Aro <[email protected]> --------- Co-authored-by: Eemeli Aro <[email protected]>
1 parent 4452a74 commit 698d508

File tree

1 file changed

+22
-6
lines changed

1 file changed

+22
-6
lines changed

spec/registry.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Implementations and tooling can greatly benefit from a
44
structured definition of formatting and matching functions available to messages at runtime.
5-
The _registry_ is a mechanism for storing such declarations in a portable manner.
5+
This specification is intended to provide a mechanism for storing such declarations in a portable manner.
66

77
## Goals
88

@@ -30,12 +30,21 @@ in order to support the following goals and use-cases:
3030
_This section is normative._
3131

3232
To be conformant with MessageFormat 2.0, an implementation MUST implement
33-
all of the formatting and selection _functions_ described in the default registry,
34-
including all of the _options_ and _option_ values, _operands_ and outputs
35-
described by the default registry.
33+
the _functions_, _options_ and _option_ values, _operands_ and outputs
34+
described in the section [Default Registry](#default-registry) below.
3635

37-
Implementations are not required to provide a registry nor to read or interpret
38-
a copy of this registry in order to be conformant.
36+
Implementations MAY implement additional _functions_ or additional _options_.
37+
In particular, implementations are encouraged to provide feedback on proposed
38+
_options_ and their values.
39+
40+
> [!IMPORTANT]
41+
> In the Tech Preview, the [registry data model](#registry-data-model) should
42+
> be regarded as experimental.
43+
> Changes to the format are expected during this period.
44+
> Feedback on the registry's format and implementation is encouraged!
45+
46+
Implementations are not required to provide a machine-readable registry
47+
nor to read or interpret the registry data model in order to be conformant.
3948

4049
The MessageFormat 2.0 Registry was created to describe
4150
the core set of formatting and selection _functions_,
@@ -63,6 +72,9 @@ a registry to support localization tooling.
6372

6473
_This section is non-normative._
6574

75+
> [!IMPORTANT]
76+
> This part of the specification is not part of the Tech Preview.
77+
6678
The registry contains descriptions of function signatures.
6779
[`registry.dtd`](./registry.dtd) describes its data model.
6880

@@ -258,6 +270,10 @@ which only expects the `accord` option:
258270
259271
# Default Registry
260272
273+
> [!IMPORTANT]
274+
> This part of the specification is part of the Tech Preview
275+
> and is **_NORMATIVE_**.
276+
261277
This section describes the functions which each implementation MUST provide
262278
to be conformant with this specification.
263279

0 commit comments

Comments
 (0)