Document notice function

[technicalpickles]

In #hubot, @arnaudmm was trying to use thenotice method like:

robot.hear /^!toto$/, (msg) -> robot.adapter.notice "#systest2", "tototo"

This didn't work because the first argument is an envelope object that should have a user or room. This does work:

robot.hear /^!toto$/, (msg) -> robot.adapter.notice {room:"#systest2"}, "tototo"

[technicalpickles]

cc hubotio/hubot#1036 for more general conversation around supporting adapter-specific responses.