Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 9 additions & 22 deletions spec/README.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,7 @@
# MessageFormat 2.0 Specification

## Table of Contents

1. [Introduction](intro.md)
1. [Conformance](intro.md#conformance)
1. [Terminology and Conventions](intro.md#terminology-and-conventions)
1. [Stability Policy](intro.md#stability-policy)
1. [Syntax](syntax.md)
1. [`message.abnf`](message.abnf)
1. [Formatting](formatting.md)
1. [Errors](errors.md)
1. [Default Function Registry](registry.md)
1. [`u:` Namespace](u-namespace.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)
> [!IMPORTANT]
> This page is not a part of the specification and is not normative.

## What is MessageFormat 2?

Expand All @@ -34,14 +20,15 @@ thus enabling gradual adoption by users of older formatting systems.
The goal is to allow developers and translators to create natural-sounding, grammatically-correct,
user interfaces that can appear in any language and support the needs of diverse cultures.

## MessageFormat 2 Specification and Syntax
## Status of the documents in this repo

The current specification starts [here](#table-of-contents) and may have changed since the publication
of the Tech Preview version.
The Tech Preview specification is [here](https://www.unicode.org/reports/tr35/tr35-73/tr35-messageFormat.html)
The editor's copy of the specification is found in this directory of this repo and starts [here](intro.md).
The editor's copy may have changed since the publication of the most recent LDML version.

The current draft syntax for defining messages can be found in [spec/syntax.md](./syntax.md).
The syntax is formally described in [ABNF](./message.abnf).
The Final Candidate specification is in [LDML 46.1](https://www.unicode.org/reports/tr35/tr35-73/tr35-messageFormat.html)
which is identical to the materials in the LDML 46.1 release in this repo.

## About

Messages can be simple strings:

Expand Down
2 changes: 1 addition & 1 deletion spec/appendices.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# DRAFT Appendices
# Appendices

## Security Considerations

Expand Down
2 changes: 1 addition & 1 deletion spec/data-model/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# DRAFT MessageFormat 2.0 Data Model
# MessageFormat 2.0 Data Model

This section defines a data model representation of MessageFormat 2 _messages_.

Expand Down
2 changes: 1 addition & 1 deletion spec/errors.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# MessageFormat 2.0 Errors
# Errors

Errors can occur during the processing of a _message_.
Some errors can be detected statically,
Expand Down
4 changes: 2 additions & 2 deletions spec/formatting.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# DRAFT MessageFormat 2.0 Formatting
# Formatting

## Introduction

Expand Down Expand Up @@ -534,7 +534,7 @@ according to their _key_ values and selecting the first one.
> > * {{Only used by fractions in Polish.}}
> > ```
>
> In the Tech Preview, feedback from users and implementers is desired about
> During the Final Candidate review period, feedback from users and implementers is desired about
> whether to relax the requirement that such a "fallback _variant_" appear in
> every message, versus the potential for a _message_ to fail at runtime
> because no matching _variant_ is available.
Expand Down
17 changes: 17 additions & 0 deletions spec/intro.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,22 @@
# MessageFormat 2.0 Specification

## Table of Contents

1. [Introduction](intro.md)
1. [Conformance](intro.md#conformance)
1. [Terminology and Conventions](intro.md#terminology-and-conventions)
1. [Stability Policy](intro.md#stability-policy)
1. [Syntax](syntax.md)
1. [`message.abnf`](message.abnf)
1. [Formatting](formatting.md)
1. [Errors](errors.md)
1. [Default Function Registry](registry.md)
1. [`u:` Namespace](u-namespace.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)

## Introduction

One of the challenges in adapting software to work for
Expand Down
6 changes: 1 addition & 5 deletions spec/syntax.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,4 @@
# DRAFT MessageFormat 2.0 Syntax

## Table of Contents

\[TBD\]
# Syntax

### Introduction

Expand Down