From 05605982fbb4cc946f966be2c8ebaee81ab3156b Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Tue, 1 Apr 2025 06:58:23 -0700 Subject: [PATCH 01/13] Draft new charter and goals for v49/v50 and beyond Fixes #1051 --- docs/goals.md | 55 +++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 47 insertions(+), 8 deletions(-) diff --git a/docs/goals.md b/docs/goals.md index 14caeed234..1519e6d717 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -1,16 +1,53 @@ # 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 the CLDR-TC. + +## Goals + +- Encourage adoption of Unicode MessageFormat as measured by developing [messageformat.unicode.org] + and other appropriate materials to include a user guide, MF1 migration guide, + implementation support, and usage materials while maintaining a high bar + as a model for other Unicode websites. +- Support a determination there are at least ### additional interoperable implementations. +- Support migration and adoption by moving all functions and options necessary to match the features of + ICU MessageFormat ("MF1") to Stable. +- Support migration and adoption by making significant additions to 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. + +## Deliverables (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` + - `u:id`, `u:dir`, and `u:locale` options +- 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 +68,8 @@ The design goals are listed below. ## Deliverables +The original deliverables were: + 1. A formal definition of the canonical data model for representing localizable _dynamic message strings_. @@ -39,7 +78,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. From b2983a0b811d611ec9502526c3c0fc1e75fdd442 Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Tue, 1 Apr 2025 07:53:33 -0700 Subject: [PATCH 02/13] Update docs/goals.md Co-authored-by: Eemeli Aro --- docs/goals.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/goals.md b/docs/goals.md index 1519e6d717..0e75305fbe 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -17,7 +17,7 @@ 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 the CLDR-TC. +The MessageFormat Working Group is a working group of the CLDR-TC. ## Goals From 1a35094a3569c5978d4cc2c3c083aaa3322e381a Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Tue, 1 Apr 2025 08:06:19 -0700 Subject: [PATCH 03/13] Update docs/goals.md Co-authored-by: Eemeli Aro --- docs/goals.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/goals.md b/docs/goals.md index 0e75305fbe..e6cb28819e 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -28,7 +28,7 @@ The MessageFormat Working Group is a working group of the CLDR-TC. - Support a determination there are at least ### additional interoperable implementations. - Support migration and adoption by moving all functions and options necessary to match the features of ICU MessageFormat ("MF1") to Stable. -- Support migration and adoption by making significant additions to the default function set to support +- 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. From 32d3a810e2c5b101fbdf0d19b96f1c1fb3252ed7 Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Tue, 1 Apr 2025 08:06:48 -0700 Subject: [PATCH 04/13] Update docs/goals.md Co-authored-by: Eemeli Aro --- docs/goals.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/goals.md b/docs/goals.md index e6cb28819e..f3b730fae4 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -40,7 +40,7 @@ The MessageFormat Working Group is a working group of the CLDR-TC. - percent formatting - Deliver at least as Technical Preview (v49) and Stable (v50) all draft functions and options - `:unit` - - `u:id`, `u:dir`, and `u:locale` options + - 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. From 35e7bbde1ef43465ac9559d1538a33fb661774c2 Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Tue, 1 Apr 2025 08:11:12 -0700 Subject: [PATCH 05/13] Don't forget v48 --- docs/goals.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/goals.md b/docs/goals.md index f3b730fae4..ec1dd4e134 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -33,7 +33,7 @@ The MessageFormat Working Group is a working group of the CLDR-TC. - Develop a machine-readable function description format or syntax to support the needs of implementations, including localization tools. -## Deliverables (v49, v50) +## Deliverables (v48, v49, v50) - Deliver as Stable all remaining functions needed to support migration from MF1 - `:datetime` and all date/time functions From 45a52d3c3619da3a6a8093b18d6931d73163e10e Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Tue, 1 Apr 2025 08:54:17 -0700 Subject: [PATCH 06/13] Update docs/goals.md --- docs/goals.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/goals.md b/docs/goals.md index ec1dd4e134..0795a63dad 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -21,10 +21,17 @@ The MessageFormat Working Group is a working group of the CLDR-TC. ## Goals -- Encourage adoption of Unicode MessageFormat as measured by developing [messageformat.unicode.org] - and other appropriate materials to include a user guide, MF1 migration guide, - implementation support, and usage materials while maintaining a high bar - as a model for other Unicode websites. +- 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 a determination there are at least ### additional interoperable implementations. - Support migration and adoption by moving all functions and options necessary to match the features of ICU MessageFormat ("MF1") to Stable. From fa3c3814440b167727f0b2f331c912c4f43e2bcd Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Mon, 12 May 2025 07:08:32 -0700 Subject: [PATCH 07/13] Update per offline discussion Co-authored-by: Eemeli Aro --- docs/goals.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/goals.md b/docs/goals.md index 0795a63dad..0c5e3c29f3 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -39,6 +39,12 @@ The MessageFormat Working Group is a working group of the CLDR-TC. 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) From 31056f1714a1aa39a9a8c1ff34cd4a71772b78ab Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Mon, 19 May 2025 09:38:38 -0700 Subject: [PATCH 08/13] Update docs/goals.md Co-authored-by: Eemeli Aro --- docs/goals.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/goals.md b/docs/goals.md index 0c5e3c29f3..a5013c53a7 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -32,7 +32,6 @@ The MessageFormat Working Group is a working group of the CLDR-TC. 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 a determination there are at least ### additional interoperable implementations. - Support migration and adoption by moving all functions and options necessary to match the features of ICU MessageFormat ("MF1") to Stable. - Support migration and adoption by expanding the default function set to support From b1a0de30aa2620ebc086e72a96b8a838e478cd32 Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Tue, 20 May 2025 12:30:58 -0700 Subject: [PATCH 09/13] Include limitations to MF1 compatibility Per the 2025-05-19 teleconference, make clear the appropriate scope of MF1 compatibility --- docs/goals.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/goals.md b/docs/goals.md index a5013c53a7..401985cb0e 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -32,8 +32,16 @@ The MessageFormat Working Group is a working group of the CLDR-TC. 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 moving all functions and options necessary to match the features of - ICU MessageFormat ("MF1") to Stable. +- 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 + or because they are specialized features unique to MF1 and which ICU is free to implement: + - ChoiceFormat (an anti-pattern) + - Date/time picture strings (an anti-pattern) + - Nested selection or partial message selection (an anti-pattern) + - `spellout` and `duration` formats (specialized functionality) + - `ordinal` _formatting_ (specialized functionality, incompetely specified in CLDR) - 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 From aa55b0d632fa8bbae5b3ced689850be76f64f4b0 Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Wed, 21 May 2025 11:28:00 -0700 Subject: [PATCH 10/13] Address comments about MF1 functionality --- docs/goals.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/goals.md b/docs/goals.md index 401985cb0e..11d35a1d73 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -35,10 +35,12 @@ The MessageFormat Working Group is a working group of the CLDR-TC. - 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 - or because they are specialized features unique to MF1 and which ICU is free to implement: + 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 (specialized functionality, potentially superseded by semantic skeletons) - Nested selection or partial message selection (an anti-pattern) - `spellout` and `duration` formats (specialized functionality) - `ordinal` _formatting_ (specialized functionality, incompetely specified in CLDR) From 7f6860c5c31c05b341cc75ca8535f617646b5a49 Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Sun, 25 May 2025 12:04:09 -0700 Subject: [PATCH 11/13] Update docs/goals.md Co-authored-by: Mark Davis --- docs/goals.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/goals.md b/docs/goals.md index 11d35a1d73..5c672edeec 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -43,7 +43,7 @@ The MessageFormat Working Group is a working group of the CLDR-TC. - Date/time and number skeletons (specialized functionality, potentially superseded by semantic skeletons) - Nested selection or partial message selection (an anti-pattern) - `spellout` and `duration` formats (specialized functionality) - - `ordinal` _formatting_ (specialized functionality, incompetely specified in CLDR) + - `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 From 394fcbb22ecbbe7ba33246661cd1afbe6cf0a8b7 Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Mon, 26 May 2025 08:11:28 -0700 Subject: [PATCH 12/13] Update docs/goals.md Co-authored-by: Mark Davis --- docs/goals.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/goals.md b/docs/goals.md index 5c672edeec..3eb721d92c 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -40,7 +40,7 @@ The MessageFormat Working Group is a working group of the CLDR-TC. 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 (specialized functionality, potentially superseded by semantic skeletons) + - 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) From d22eb4dbdb3152e4be0ecb153e7aef7433190359 Mon Sep 17 00:00:00 2001 From: Addison Phillips Date: Mon, 2 Jun 2025 10:49:38 -0700 Subject: [PATCH 13/13] Update docs/goals.md --- docs/goals.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/goals.md b/docs/goals.md index 3eb721d92c..57fac73c66 100644 --- a/docs/goals.md +++ b/docs/goals.md @@ -1,6 +1,7 @@ # Goals and Non-Goals -This document contains the charter for the MessageFormat Working Group (MFWG) +This document contains the DRAFT charter for the MessageFormat Working Group (MFWG), +which is subject to approval from the CLDR-TC, and informs decisions about the scope and priority of its efforts. ## Charter