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