Skip to content
Addison Phillips edited this page Nov 8, 2024 · 137 revisions

MessageFormat Working Group

Welcome to the home page for the MessageFormat Working Group, a subgroup of the Unicode CLDR-TC.

Charter

The Message Format Working Group (MFWG) is tasked with developing an industry standard for the representation of localizable message strings to be a successor to ICU MessageFormat. MFWG will recommend how to remove redundancies, make the syntax more usable, and support more complex features, such as gender, inflections, and speech. MFWG will also consider the integration of the new standard with programming environments, including, but not limited to, ICU, DOM, and ECMAScript, and with localization platform interchange. The output of MFWG will be a specification for the new syntax, which is expected to be on track to become a Unicode Technical Standard.

Participation / Joining the Working Group

We are looking for participation from software developers, localization engineers and others with experience in Internationalization (I18N) and Localization (L10N). If you wish to contribute to this work, please review the information about the Contributor License Agreement.

To follow this work:

  1. Apply to join our mailing list
  2. Watch this repository (use the "Watch" button in the upper right corner)

To contribute to this work, in addition to the above:

  1. Each individual MUST have a copy of the CLA on file.
  2. Individuals who are employees of Unicode Member organizations SHOULD contact their member representative. Individuals who are not employees of Unicode Member organizations MUST contact the chair to request Invited Expert status. Employees of Unicode Member organizations MAY also apply for Invited Expert status, subject to approval from their member representative.

Meeting Agenda

This is the agenda document for upcoming calls of the MessageFormat subcommittee. We normally meet weekly on Mondays at 9:30 Pacific (America/Los_Angeles). This is currently UTC+7.

See here for your local time.

Information on joining calls is found in the calendar invite.

Scribe

This block reserved for scribe rotation.

Recent scribes:

  • 2024-11-03 ECH
  • 2024-10-28 HGO
  • 2024-10-21 APP
  • 2024-10-14 MIH
  • 2024-10-07 TIM
  • 2024-09-30 EAO
  • 2024-09-09 HGO
  • 2024-09-02 (no quorum)
  • 2024-08-26 ECH
  • 2024-08-19 MIH, ECH
  • 2024-08-12 RGN
  • 2024-08-05 TIM
  • 2024-07-29 ECH
  • 2024-07-22 HGO
  • 2024-07-15 LCA, USA
  • 2024-07-08 MIH
  • 2024-07-01 TIM
  • 2024-06-24 STA
  • 2024-06-17 ECH
  • 2024-06-10 n/a
  • 2024-06-03 MRR
  • 2024-05-20 MIH
  • 2024-05-13 USA, TIM, ECH
  • 2024-05-06 TIM, ECH
  • 2024-04-29 ECH
  • 2024-04-22 MRR
  • 2024-04-15 MIH
  • 2024-04-08 MRR
  • 2024-03-25 TIM
  • 2024-03-18 MIH
  • 2024-03-04 RGN
  • 2024-02-26 ECH
  • 2024-02-xx everyone
  • 2024-02-12 MIH
  • 2024-02-05 SCA
  • 2024-01-29 TIM
  • 2024-01-22 STA
  • 2024-01-15 MIH
  • 2024-01-08 SCA (removing pre-2024 history)

Notes Document for The Upcoming Call

NOTE WELL

The next regular meeting will be 11 November 2024 and is a Regular WG Teleconference call.

Homework

  • Review all PRs!

Agenda

Topic: Info Share

Topic: Schedule for Release

Topic: resolve-candidate

The following issues are proposed for resolve:

Topic: Agenda+ Topics

Topic: Stability policy should cover option values (#928)

This is an issue that is an outgrowth of #925. We should discuss this minor alteration of the proposed stability policy.

Topic: Add a :number offset option (#701)

Mark proposed adding an offset option to :number for parity with MF1. We discussed including this last week, but need a PR. Mihai created a PR.

Topic: Fix fallback value definition and use (#903)

This change appears to be complete, but has no approvals. Please review this work before the call.

Topic: Defining “locale” options for date/time related functions (#911)

These options don’t appear to be controversial, but details of their nomenclature and such are still outstanding. Let’s discuss before merging any changes.

Topic: Currency Formatting (#915)

Last week we discussed concluding this work. The remaining topic of discussion is the currencyDisplay option’s values. Let’s discuss that option and then merge the results.

Topic: Unit Formatting (#922)

Last week we discussed taking :unit as optional if our work was done. Propose merging it.

To request that the chair add an issue to the agenda, add the label Agenda+ To request that the chair add an agenda item, send email to the message-format-wg group email.

Topic: Active PR review

Discussion of active PRs. We will merge or reject them in the call. The recommendation "discuss" is to ensure there is WG consensus before merging. The recommendation "merge with edits" is to merge once existing comments have been addressed. Discussion of active PRs. We will merge or reject them in the call.

PR Description Recommendation
#927 Replace Composition with Resolved Value sections for default functions Merge
#926 Adding a :number offset option Discuss
#925 Provide normative guidance on function/option/option value implementation Merge
#923 Test schema: allow src property to either be a string or array of strings Discuss, Merge
#922 Implement :unit as OPTIONAL in the registry Merge
#915 Implement :currency function in default registry Discuss, Merge
#911 Define locale options for :datetime :date and :time Discuss, Merge
#903 Fix fallback value definition and use Discuss
#842 Match numbers numerically Reject
#584 Add new terms to glossary Reject

Topic: Design Status

What is the status of our various design docs?

Doc Description Status
dataflow-composability Data Flow for Composable Functions Proposed (Obsolete?)
maintaining-registry Maintaining the function registry Proposed, Discuss
number-selection Define how selection on numbers happens Revision Proposed
Accepted, Obsolete, and Rejected Designs
Doc Description Status
function-composition-part-1 Function Composition Obsolete
beauty-contest Choose between syntax options Obsolete
selection-matching-options Selection Matching Options (ballot) Obsolete
syntax-exploration-2 Balloting of the revised syntax used in the Tech Preview Obsolete
variants A collection of message examples which require a branching logic to handle grammatical variations Obsolete
formatted-parts Define how format-to-parts works Rejected
quoted-literals Document the rationale for including quoted literals in MF and for choosing the | as the quote symbol Accepted
builtin-registry-capabilities Tech Preview default registry definition Accepted
code-mode-introducer Choose the pattern for complex messages Accepted
data-driven-tests Capture the planned approach for the test suite Accepted
default-registry-and-mf1-compatibility Default Registry and MF1 Compatibility Accepted
delimiting-variant-patterns Delimiting of Patterns in Complex Messages (Ballot) Accepted
error-handling Decide whether and what implementations do after a runtime error Accepted
exact-match-selector-options Choose the name for the “exact match” selector function (this is :string) Accepted
expression-attributes Define how attributes may be attached to expressions Accepted
open-close-placeholders Describe the use cases and requirements for placeholders that enclose parts of a pattern Accepted
overriding-extending-namespacing Defines how externally-authored functions can appear in a message; how externally authored options can appear; and effect of namespacing Accepted
pattern-exterior-whitespace Specify how whitespace inside of a pattern (at the start/end) works Accepted
string-selection-formatting Define how selection and formatting of string values takes place. Accepted
variable-mutability Describe how variables are named and how externally passed variables and internally defined variables interact Accepted
bidi-usability Manage bidi isolation Accepted
selection-declaration Effect of selectors on subsequent placeholders Accepted

Topic: AOB?