diff --git a/spec/data-model/README.md b/spec/data-model/README.md index 1194b331e4..4058894b56 100644 --- a/spec/data-model/README.md +++ b/spec/data-model/README.md @@ -1,4 +1,4 @@ -# MessageFormat 2.0 Data Model +# Interchange Data Model This section defines a data model representation of MessageFormat 2 _messages_. @@ -33,26 +33,14 @@ This data model might also be used to: To ensure compatibility across all platforms, this interchange data model is defined here using TypeScript notation. -Two equivalent definitions of the data model are also provided: - -- [`message.json`](./message.json) is a JSON Schema definition, - for use with message data encoded as JSON or compatible formats, such as YAML. -- [`message.dtd`](./message.dtd) is a document type definition (DTD), - for use with message data encoded as XML. +An equivalent JSON Schema definition [`message.json`](./message.json) is also provided, +for use with message data encoded as JSON or compatible formats, such as YAML. Note that while the data model description below is the canonical one, -the JSON and DTD definitions are intended for interchange between systems and processors. -To that end, they relax some aspects of the data model, such as allowing +the JSON Schema definition is intended for interchange between systems and processors. +To that end, it relaxes some aspects of the data model, such as allowing declarations, options, and attributes to be optional rather than required properties. -> [!NOTE] -> Users relying on XML representations of messages should note that -> XML 1.0 does not allow for the representation of all C0 control characters (U+0000-U+001F). -> Except for U+0000 NULL , these characters are allowed in MessageFormat 2 messages, -> so systems and users relying on this XML representation for interchange -> might need to supply an alternate escape mechanism to support messages -> that contain these characters. - > [!IMPORTANT] > The data model uses the field name `name` to denote various interface identifiers. > In the MessageFormat 2 [syntax](/spec/syntax.md), the source for these `name` fields diff --git a/spec/data-model/message.dtd b/spec/data-model/message.dtd deleted file mode 100644 index bc51dd1590..0000000000 --- a/spec/data-model/message.dtd +++ /dev/null @@ -1,43 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/spec/intro.md b/spec/intro.md index 24a272ea66..3be5175ffc 100644 --- a/spec/intro.md +++ b/spec/intro.md @@ -12,7 +12,7 @@ 1. [Errors](errors.md) 1. [Default Function Registry](functions/README.md) 1. [`u:` Namespace](u-namespace.md) -1. [Interchange data model](data-model/README.md) +1. [Interchange Data Model](data-model/README.md) 1. [Appendices](appendices.md) 1. [Security Considerations](appendices.md#security-considerations) 1. [Acknowledgements](appendices.md#acknowledgements)