Skip to content

Commit b48c4b3

Browse files
authored
Prepare front-door for Tech Preview
This includes a short paragraph under "What is MessageFormat 2?" whose purpose is to satisfy #693 (the need for a v45 "intro paragraph")
1 parent 8f208fa commit b48c4b3

File tree

1 file changed

+41
-1
lines changed

1 file changed

+41
-1
lines changed

README.md

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,45 @@ The Message Format Working Group (MFWG) is tasked with developing an industry st
1010
- [Goals and Non-Goals](docs/goals.md)
1111
- [Record of Consensus Decisions](docs/consensus_decisions.md)
1212

13-
## MessageFormat 2 Draft Syntax
13+
## MessageFormat 2 Technical Preview
14+
15+
The MessageFormat 2 specification was accepted by the CLDR-TC on 2024-02-28
16+
as a new part of the LDML specification.
17+
This specification is being released as a "Tech Preview",
18+
which means that the stability policy is not in effect and feedback from
19+
users and implementers might result in changes to the syntax, data model,
20+
functions, or other normative aspects of MessageFormat 2.
21+
Such changes are expected to be minor and, to the extent possible,
22+
to be compatible with what is defined in the Tech Preview.
23+
24+
The MFWG welcomes any and all feedback, including bugs reports, implementation
25+
reports, success stories, feature requests, requests for clarification,
26+
or anything that would be helpful in stabilizing the specification and
27+
promoting widespread adoption.
28+
29+
The MFWG specifically requests feedback on the following issues:
30+
- How to perform non-integer exact number selection (#675)
31+
- Whether `markup` should support additional spaces (#650)
32+
- Whether "attribute-like" behavior is needed and what form it should take (#642)
33+
- Whether to relax constraints on complex message start (#610)
34+
- Whether omitting the `*` variant key should be permitted (#603)
35+
36+
## What is MessageFormat 2?
37+
38+
MessageFormat 2 defines the data model, syntax, processing, and conformance requirements
39+
for the next generation of dynamic messages.
40+
It is intended for adoption by programming languages and APIs.
41+
It enables the integration of internationalization APIs (such as date and number formats),
42+
grammatical matching (such as plurals or genders),
43+
as well as user-defined formats and message selectors,
44+
so that developers and translators can create natural, grammatically-correct,
45+
fluent user interfaces.
46+
47+
## MessageFormat 2 Specification and Syntax
48+
49+
The current specification starts [here](spec/README.md) and may have changed since the publication
50+
of the Tech Preview version.
51+
The Tech Preview specification is [here](tr35-messageformat.md) (link to follow).
1452

1553
The current draft syntax for defining messages can be found in [spec/syntax.md](./spec/syntax.md).
1654
The syntax is formally described in [ABNF](spec/message.abnf).
@@ -59,6 +97,8 @@ See more examples and the formal definition of the grammar in [spec/syntax.md](.
5997

6098
## Sharing Feedback
6199

100+
Technical Preview Feedback: [file an issue here](https://github.com/unicode-org/message-format-wg/issues/new?labels=Preview-Feedback&projects=&template=tech-preview-feedback.md&title=%5BFEEDBACK%5D+)
101+
62102
We invite feedback about the current syntax draft, as well as the real-life use-cases, requirements, tooling, runtime APIs, localization workflows, and other topics.
63103

64104
- General questions and thoughts → [post a discussion thread](https://github.com/unicode-org/message-format-wg/discussions).

0 commit comments

Comments
 (0)