-
-
Notifications
You must be signed in to change notification settings - Fork 36
Draft new charter and goals for v49/v50 and beyond #1065
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
0560598
b2983a0
1a35094
32d3a81
35e7bbd
45a52d3
fa3c381
31056f1
b1a0de3
aa55b0d
7f6860c
394fcbb
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,75 @@ | ||
# Goals and Non-Goals | ||
|
||
This document defines the purpose of the Message Format Working Group (MFWG) | ||
and informs the decisions about the scope and the priorities of its efforts. | ||
This document contains the charter for the MessageFormat Working Group (MFWG) | ||
and informs decisions about the scope and priority of its efforts. | ||
|
||
## Goals | ||
## Charter | ||
|
||
The primary task of the MFWG is to develop an industry standard for the | ||
representation of localizable dynamic message strings. A **_dynamic message | ||
string_** is a string whose content changes due to the value of or insertion | ||
A **_dynamic message string_** is a string whose content changes due to the value of or insertion | ||
of some data value or values. | ||
|
||
The design goals are listed below. | ||
The _Unicode MessageFormat Standard_ is an industry standard for the representation | ||
of localizable _dynamic message strings_. | ||
|
||
The MessageFormat Working Group maintains and extends the Unicode MessageFormat Standard, | ||
provides documentation; | ||
encourages implementation, including the development of tools and best practices; | ||
manages default and Unicode-defined function sets; | ||
and provides for interoperability with other standards. | ||
|
||
The MessageFormat Working Group is a working group of the CLDR-TC. | ||
|
||
## Goals | ||
|
||
- Maintain and develop the [messageformat.unicode.org] site, | ||
maintaining a high bar (as a model for other Unicode documentation), | ||
including at least | ||
a user guide, | ||
and a migration guide from other formats (including ICU MessageFormat). | ||
- Encourage adoption of Unicode MessageFormat by: | ||
providing implementation support materials; | ||
creating tests; | ||
linking to success stories, tools, and implementations; | ||
supporting or hosting workshops or supporting presentations by members; | ||
and supporting adoption by encapsulating standards (such as ECMA-402, MessageResource, etc.) | ||
- Support migration and adoption by publishing as Stable in the default function set | ||
the functions and options needed to provide compatibility with ICU MessageFormat ("MF1"). | ||
Note that certain features of MF1 have been deliberately excluded from this goal | ||
because they are in conflict with the design goals of Unicode MessageFormat, | ||
because they are specialized features unique to MF1 (which ICU is free to implement), | ||
or because they might be superseded by newer specifications: | ||
- ChoiceFormat (an anti-pattern) | ||
- Date/time picture strings (an anti-pattern) | ||
- Date/time and number skeletons (potentially superseded by semantic skeletons) | ||
- Nested selection or partial message selection (an anti-pattern) | ||
- `spellout` and `duration` formats (specialized functionality) | ||
- `ordinal` _formatting_ (specialized functionality) | ||
- Support migration and adoption by expanding the default function set to support | ||
additional use cases. | ||
- Develop a machine-readable function description format or syntax to support the needs of | ||
implementations, including localization tools. | ||
- Define a standard vocabulary for expression attributes and message properties/metadata, | ||
to enable better interoperation between translation tools and platforms. | ||
- Incubate and support working groups or interest groups | ||
that promote adoption of Unicode MessageFormat, | ||
such as the proposed working group to develop a standard message resource format, | ||
i.e. a new file format for bundles or collections of messages. | ||
|
||
## Deliverables (v48, v49, v50) | ||
|
||
- Deliver as Stable all remaining functions needed to support migration from MF1 | ||
- `:datetime` and all date/time functions | ||
- percent formatting | ||
- Deliver at least as Technical Preview (v49) and Stable (v50) all draft functions and options | ||
- `:unit` | ||
- the `u:locale` option | ||
- Deliver as Technical Preview additional functions to support significant additional functionality. | ||
Such functions could include: lists, ranges, relative time, inflection. | ||
- Deliver as Technical Preview a machine-readable function description format or syntax. | ||
|
||
## Design Goals | ||
|
||
The original design goals are listed below. | ||
|
||
1. Allow users to write messages that are both grammatically | ||
correct and can be translated in a grammatically correct manner | ||
|
@@ -31,6 +90,8 @@ The design goals are listed below. | |
|
||
## Deliverables | ||
|
||
The original deliverables were: | ||
Comment on lines
91
to
+93
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. What's the utility of retaining this? If there is a need, then the section title ought to be qualified to reflect the status. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. It's temporary while we work through the current charter. |
||
|
||
1. A formal definition of the canonical data model for representing | ||
localizable _dynamic message strings_. | ||
|
||
|
@@ -39,7 +100,7 @@ The design goals are listed below. | |
escape sequences, whitespace, markup, as well as parsing errors. | ||
|
||
3. A specification for a one-to-one mapping between the data model and XLIFF. | ||
_Note: This deliverable is not included in the LDML46.1 Final Candidate release._ | ||
_Note: This deliverable was not included in the LDMLv47 release._ | ||
|
||
4. A specification for resolving messages at runtime, including | ||
runtime errors. | ||
|
Uh oh!
There was an error while loading. Please reload this page.