Hi devs,

For the new messageSender macro [1][2], I chose the name using the
"attachmentSelector" macro as a template: "<object><personified-action>"

Vincent did not really like the "messageSender" name and proposed
"message", "sendMessage" or "userMessage".

Since AFAIK we don`t currently have a naming convention for wiki macro
names, I`d like to propose that we stick to the patterns:
1) "<object><personified-action>" (attachmentSelector, messageSender) for
action-oriented macros and
2) "<object(s)>" (documents, spaces, activity) for display-oriented macros

For 2), it's pretty clear, but for 1), I personally prefer
"<object><personified-action>" since overall it is a noun and, in english,
the phrase "messageSender macro" sounds better to me than "sendMessage
macro". Also, I think that the main action of the action-oriented macro
should be reflected in its name.

I`d like your opinion on the matter and also new proposals if you have any.

Here's my +1 for 1) and 2).

Thanks,
Eduard

----------
[1] http://xwiki.markmail.org/thread/mxpkpqfplbznfgbd
[2] http://jira.xwiki.org/browse/XWIKI-7679
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs

Reply via email to