message-format-wg icon indicating copy to clipboard operation
message-format-wg copied to clipboard

[FEEDBACK] Specify what kind of user

Open macchiati opened this issue 9 months ago • 5 comments

We use the term 'user' in many different ways (in the 47 instances in the spec):

  • end users — eg, people seeing a message on their screen produced by MF
  • message writers — eg, people composing messages with MF syntax (and perhaps custom functions)
  • custom function writers — eg, people creating custom functions for use in their companies' localization systems

In practice, these are typically (but not always) disjoint.

We seem to use "implementations" and "implementers" contrastively, meaning an implementation of the MF framework and standard functions, but excluding the above.

Sometimes it is clear what the meaning of 'users' is. For example:

  • "One of the challenges in adapting software to work for users with different languages and cultures"
  • "An implementation MAY allow custom functions to be defined by users." seems to be directed at custom function writers.

But often it isn't clear. This is not a blocker, but I think we should clear up when we are talking to which kind of users.

macchiati avatar Feb 20 '25 20:02 macchiati

My comment elsewhere was basically: there are different sorts of users, but I believe (perhaps incorrectly) that all of our uses are clear. Can you identify specific instances that are a problem? I mean, you quote two, but each of those seem clear to me?

48 okay?

aphillips avatar Feb 20 '25 23:02 aphillips

Yes, 48 ok

macchiati avatar Feb 21 '25 01:02 macchiati

Added LDML47 to the others for visibility, but let me know if that is not following your process, @aphillips

macchiati avatar Feb 21 '25 02:02 macchiati

@macchiati Can you enumerate places you'd like to see changed or which you found unclear?

aphillips avatar Mar 31 '25 16:03 aphillips

I agree it would be nice to reference different types of users a bit more explicitly. Some already are, as far as I've seen.

My two cents on the users that exist:

  • End users - People who see formatted messages
  • Translators - People who translate messages
  • Authors - People who write messages
  • Consumers - People who consume implementations
  • Implementers - People who write implementations

And perhaps just "users" could remain more broad/generic where appropriate.

bearfriend avatar Apr 01 '25 23:04 bearfriend